エンジニアリングノート

App Store ConnectのビルドがProcessingのままの場合は?2026年のトラブルシューティングガイド

App Store ConnectのビルドがProcessingのままの場合は?2026年のトラブルシューティングガイド

Appleは、アップロードから24時間を超えてもProcessingのままの場合、問題がある可能性を示しています(Appleのビルドアップロード状態の説明)。

Processingのまま → TestFlightの一覧ではなく、まずBuild Uploadsの記録と詳細を確認します。
24時間を超えても変わらない → 詳細を記録し、Feedback Assistantから報告するかAppleサポートへ連絡します。

この記事は、XcodeやTransporterからビルドをアップロードした後、状態がProcessingのまま変わらない開発者向けです。TestFlight配信を管理する小規模チームや、アップロード環境の切り分けを担当する人にも役立ちます。

まず確認するのはTestFlightの一覧ではなくアップロード記録です

App Store Connectには、アップロードの処理状況を確認するBuild Uploadsと、処理後のビルドを確認するTestFlightのビルド一覧があります。役割が異なるため、TestFlightに表示されないだけでアップロード失敗と決めつけず、先にBuild Uploadsを確認します(Appleのビルドとメタデータの確認手順)。

対象アプリを開き、TestFlightのBuild Uploadsで該当する記録を探します。アプリ名だけでなく、プラットフォーム、バージョン、ビルド番号も照合してください。別のアプリや以前のビルドを見ていると、状態を誤って判断するおそれがあります。

状況 画面で確認する内容 次に行うこと
Processing Build Uploadsの記録と詳細、対象アプリ、バージョン、ビルド番号 まず記録を確認。24時間を超えて変化しない場合はAppleの案内に沿って報告または問い合わせ
Failed 選択したアップロード記録に表示されるエラー、警告、情報 内容に応じてプロジェクトや署名を修正し、必要な場合に再アップロード
CompleteだがTestFlightに見当たらない アプリ、プラットフォーム、バージョン、ビルドの選択、テスト配信の状態 アップロード処理とテスターへの配信設定を分けて確認
アップロード記録がない Xcode、Transporter、APIなど、利用したアップロード手段の完了表示とログ アップロード操作が完了したかを確認。記録がないだけでサーバー側の原因と断定しない

Appleの説明では、Processingはアップロードしたビルドの処理中、Failedはアップロード処理に問題があった状態、Completeは処理が完了した状態です。画面上の状態名を、原因そのものと取り違えないことが重要です(Appleのビルドアップロード状態、Appのビルド状態)。

Processingが続くときは、記録と時間を分けて確認します

Processingが表示されている場合、最初に見るのは待ち時間だけではありません。対象のアップロード記録が存在するか、アプリやビルドの識別情報が一致するか、詳細欄に追加情報があるかを確認します。

Appleは、Processingが24時間を超えた状態を、問題が発生している可能性のあるケースとして案内しています。この時間は処理の所要時間の約束ではありません。24時間を過ぎたら必ず失敗する、あるいはその時間内に処理される、と読み替えないでください(Appleの状態別の案内)。

記録の有無を先に確かめます

XcodeやTransporterの画面でアップロード完了が確認できても、App Store Connect上で対象の記録を見つけられない場合があります。アプリの選択違い、プラットフォーム違い、バージョンやビルド番号の見間違いを確認し、それでも記録がなければ、アップロードを実行した側のログを見ます。

Appleの案内では、アップロード後にビルドの処理が行われます。処理中の表示が続く場合は、同じビルドを反射的に再送するより、既存の記録が何を示しているかを確認してください(Appleのビルドアップロード手順)。

24時間を超えたら、証拠をそろえて報告します

Processingが24時間を超えても更新されない場合は、画面の状態と詳細を記録します。Appleが案内するFeedback Assistantへの報告、またはAppleサポートへの問い合わせに進みます。特定の原因や復旧時刻を推測して、再アップロードを繰り返す必要はありません。

問い合わせに備え、対象アプリ、プラットフォーム、バージョン、ビルド番号、アップロードした日時、表示されている状態と詳細をまとめます。ログを添付する場合は、秘密鍵、認証情報、個人情報が含まれていないか確認し、必要な範囲に絞ってください。

Processingが続くときに、TestFlightで見つからないことだけを根拠に再送しないでください。まずBuild Uploadsの記録を確認し、アップロード完了の有無とApple側での処理状況を分けて整理します。

Failedでは詳細を読み、修正内容を決めます

Failedと表示されたら、該当するBuild Uploadsの記録を開いて、エラー、警告、情報を確認します。状態名だけから、署名の誤りやApple側の障害など、特定の原因を断定することはできません。画面に示された詳細と、手元のアップロードログを突き合わせます。

指摘がプロジェクト設定や署名に関わる場合は、該当箇所を修正してから新しいアップロードを検討します。アップロード手段で完了が報告されていない場合は、まずその手順やログを確認します。Xcodeからの配布に関する操作は、AppleのXcodeを使ったベータテストとリリースの手順も参照できます。

ログにエラーが記録されている場合は、メッセージと前後の処理を抜き出して整理します。たとえば、手元に保存したログファイルを確認する場合は、次のように該当語を検索できます。

grep -Ei 'upload|error|failed|completed' upload.log

出力形式の例です。実際のエラー内容や根本原因を示すものではありません。

upload: completed
error: example message

ログに該当語がないことは、アップロード成功の証明にはなりません。XcodeやTransporterが示す操作結果、App Store Connectの記録、ログを合わせて判断します。

処理完了後にTestFlightで見つからない場合は別の確認に移ります

Build Uploadsで処理が完了していても、TestFlightの一覧で期待するビルドをすぐに見つけられない場合があります。まず対象アプリとプラットフォームを選び直し、バージョンとビルド番号がアップロード記録と一致するかを確認します。

次に、ビルド処理の完了と、テスターが利用できる状態になっていることを区別します。アップロードされたビルドは処理を経て表示されますが、テスト配信にはテスターの追加など別の手順が関係します(Appleの内部テスター追加手順)。処理完了をAppの審査完了や公開済みと同じ意味に扱わないでください。App Store Connect上の作業全体は、AppleのApp Store Connectワークフローでも確認できます。

原因を決める前に、アップロード側と処理側を切り分けます

アップロードを実行したアプリやツールが完了を報告したか、App Store Connectに対応するアップロード記録が作成されているかを見ます。この二つを確認すると、ローカルのアップロード操作が完了していないケースと、記録がProcessingのまま進まないケースを分けて調べられます。

観察できる状況 主に確認する場所 判断のしかた
XcodeやTransporterで完了が確認できず、記録も見つからない 実行した操作の結果、アップロードログ、選択したアプリ まずローカル側のアップロードが完了したかを調べる
App Store Connectに記録があり、Processingが続いている Build Uploadsの詳細、アップロード日時 Appleの示す24時間の目安を確認し、超えていれば報告または問い合わせを検討する
記録がFailedになっている Failedの詳細、アップロードログ エラーの内容に応じて修正し、必要な場合に再アップロードする
Completeだが目的のビルドを確認できない 選択中のアプリ、プラットフォーム、ビルド、配信設定 処理状態とTestFlightでの配信条件を分けて見直す

この表は切り分けの順序を示すもので、表示だけで原因を確定するものではありません。ローカルの操作が未完了ならアップロードログを優先し、記録がProcessingのまま24時間を超えているならAppleの案内に沿って対応します。

遠隔のMacを使ってビルドや公開作業を行う場合も、状態確認の考え方は同じです。実際の作業環境を整える前に、NUMACSの利用開始ガイドで利用手順を確認し、ログを保存できる運用かを検討すると、後から状況を説明しやすくなります。

よくある質問

Processingが続く場合、どの時点で問い合わせますか

Appleは、Processingが24時間を超えても続く場合に問題の可能性を示し、Feedback Assistantでの報告またはサポートへの連絡を案内しています。これは通常の処理時間の保証ではありません。状態の詳細とアップロード情報を整理してから問い合わせます。

ProcessingのビルドがTestFlightに表示されない場合はどうしますか

Build Uploadsに該当記録がありProcessingなら、TestFlightの一覧に見当たらないことだけで失敗と判断しません。対象アプリ、プラットフォーム、バージョン、ビルド番号を照合し、処理完了後も表示されない場合は、テスターへの配信設定を別に確認します。

Failedの理由はどこで確認できますか

TestFlightのBuild Uploadsから該当記録を選択し、エラー、警告、情報を確認します。その内容とXcodeやTransporterのログを比較してから修正箇所を決めます。状態名だけから根本原因を決めつけたり、修正せずに同じアップロードを繰り返したりしないでください。

24時間を超えても処理中なら、どこへ連絡しますか

Feedback Assistantから報告するか、Appleサポートへ連絡します。アプリとプラットフォーム、バージョン、ビルド番号、アップロード日時、Build Uploadsの表示内容、関連ログをそろえてください。記録がまだ存在しない場合は、先にアップロード操作が完了したかをログで確認します。

ローカルで何度も再アップロードすると、ディスク容量や作業時間を使ううえ、どの記録が対象か分かりにくくなることがあります。原因がApple側の処理中であれば、手元のMacを入れ替えても状態確認の代わりにはなりません。継続的な公開作業のためにMac環境を用意する必要があり、専用機の購入や管理を避けたい場合は、NUMACSの利用プラン比較を確認し、遠隔Macのレンタルが作業形態に合うか判断してください。

よくある質問

Processingのまま何時間も変わらない場合、どの時点で異常と考えればよいですか?

Appleは、アップロードが24時間を超えてもProcessingのままの場合、問題がある可能性を示しています。これは通常の処理時間を保証する基準ではありません。Build Uploadsの詳細を確認し、24時間を超えて更新されなければ、Feedback Assistantから報告するかAppleサポートへ連絡してください。

ProcessingのビルドがTestFlightに出てこないときは、どこを確認しますか?

まずTestFlightのBuild Uploadsで、対象アプリ、プラットフォーム、バージョン、ビルド番号が正しいか確認します。アップロード記録がProcessingなら、一覧に表示されないことだけで失敗と判断しないでください。処理完了後も見えない場合は、対象アプリやビルドの選択、テスターへの配信設定を別々に確認します。

App Store ConnectでFailedと表示された場合、原因の詳細はどこで見られますか?

TestFlightのBuild Uploadsで該当するアップロード記録を選び、表示されるエラー、警告、情報を確認します。内容を読まずに再アップロードするのではなく、指摘がプロジェクト設定や署名に関するものか、アップロード操作の未完了なのかを切り分けてから修正します。

アップロードから24時間を超えても処理中なら、誰に連絡すればよいですか?

Appleの案内に沿って、Feedback Assistantからフィードバックを送るか、Appleサポートへ問い合わせます。対象アプリとプラットフォーム、バージョン、ビルド番号、アップロード日時、Build Uploadsの状態と詳細、関連ログをまとめておくと、状況を説明しやすくなります。

Numacs クラウドMac

ビルド環境の再現性を、NUMACSで整えませんか?

NUMACSなら、共有型の仮想環境ではない専用物理Macで、macOSのビルド環境を構築できます。

デバイスを選んで注文