PC パソコン

Xcode「Upload failed」の原因と解決方法

XcodeからApp Store Connectへアプリをアップロードする際に、処理の途中で「Upload failed」と表示され、アップロードを完了できないことがあります。このエラーは、署名設定、App Store Connect側の情報、ネットワーク、アーカイブ内容、Xcodeの状態など複数の原因で発生します。ここでは代表的な原因と確認手順、解決方法を順番に解説します。

「Upload failed」とは

「Upload failed」は、XcodeのOrganizerなどからArchiveをApp Store Connectへ送信する処理が正常に完了しなかったときに表示されるエラーです。表示自体は総称的なため、実際の原因はその直前や詳細ログに表示されているメッセージを確認する必要があります。

代表的な表示例:

Upload failed
The operation couldn’t be completed.

主な原因

  • Apple Developerの証明書やProvisioning Profileに問題がある
  • Bundle IdentifierやTeam設定が一致していない
  • App Store Connect側に同じバージョン・ビルド番号が存在する
  • Archiveに不正な署名や不足したEntitlementsが含まれている
  • XcodeまたはmacOS側の一時的な認証情報が壊れている
  • ネットワーク、VPN、プロキシ、ファイアウォールなどが通信を妨げている
  • App Store Connect側で一時的な障害が発生している

代表的な発生状況

特に発生しやすいのは、証明書を更新した直後、TeamやBundle Identifierを変更した後、Xcodeを更新した後、同じVersionとBuildのArchiveを再送信した場合です。また、会社や学校など制限のあるネットワーク環境ではアップロード通信が途中で失敗することがあります。

確認手順

1. Organizerの詳細ログを確認する

XcodeでWindow → Organizerを開き、対象Archiveのアップロード結果を確認します。「Upload failed」だけでなく、その直前に表示されている具体的なエラーを探してください。

2. VersionとBuildを確認する

Target → General → IdentityでVersionとBuildを確認します。App Store Connectへ一度送信済みのビルド番号は再利用できないため、必要に応じてBuild番号を増やします。

Version: 1.2.0
Build: 15

3. Signing & Capabilitiesを確認する

Target → Signing & CapabilitiesでTeam、Bundle Identifier、Signing Certificate、Provisioning Profileが正しいか確認します。Automatic Signingを利用している場合は「Automatically manage signing」が有効になっているかも確認します。

解決方法1:Build番号を更新して再Archiveする

同じBuild番号をすでにApp Store Connectへ送信している場合は、Build番号を増やしてから再度Archiveします。

CFBundleVersion = 16

Build番号変更後はProduct → Archiveから新しいArchiveを作成し、再アップロードします。

解決方法2:署名設定を更新する

Signing & Capabilitiesで正しいTeamを選択し、Automatic Signingをいったん無効化して再度有効化すると、Provisioning Profileが再取得されることがあります。

手動署名の場合は、Apple Developerで有効なDistribution証明書とApp Store用Provisioning Profileが用意されているか確認してください。

解決方法3:Apple IDの認証を更新する

XcodeのSettings → AccountsからApple IDの状態を確認します。認証情報に問題がある場合は、一度サインアウトして再度サインインすることで改善することがあります。

証明書やチーム情報を変更する前に、現在の設定内容を控えておくと復元しやすくなります。

解決方法4:DerivedDataを削除する

Xcode内部の一時データが壊れている場合はDerivedDataを削除してから再ビルドします。

rm -rf ~/Library/Developer/Xcode/DerivedData/*

削除後にXcodeを再起動し、Product → Clean Build Folderを実行してから新しいArchiveを作成します。

解決方法5:Archiveを作り直す

古いArchiveの署名情報や埋め込みプロファイルに問題がある場合は、既存Archiveを再利用せず、新しくArchiveを作成します。特に証明書やCapabilitiesを変更した後は、新しいArchiveを作ることが重要です。

解決方法6:ネットワーク環境を変更する

VPN、プロキシ、企業ネットワーク、セキュリティソフトなどがApp Store Connectへの通信を妨げる場合があります。VPNを切る、別のWi-Fiへ接続する、有線LANへ切り替えるなどして再試行します。

解決方法7:時間を置いて再試行する

Apple側のサービス障害や混雑が原因の場合、ローカル設定を変更しても改善しません。XcodeやApp Store Connectの状態に問題が見当たらない場合は、時間を置いて再度アップロードしてください。

コマンドでArchiveを確認する

xcodebuildを使用してArchiveを作成し、Xcode GUI以外でもビルドが正常に完了するか確認できます。

xcodebuild -scheme YourScheme \
  -configuration Release \
  -archivePath ./build/YourApp.xcarchive \
  archive

ここでエラーが出る場合は、アップロード処理より前のビルド・署名工程に問題がある可能性があります。

注意点

  • 「Upload failed」は原因そのものではなく、アップロード失敗の最終結果を示すメッセージです。
  • 同時に表示されるITMS-xxxxxなどのコードや署名エラーがある場合は、そちらを優先して確認してください。
  • 同じVersionでもBuild番号を増やせば新しいビルドとして送信できます。
  • 証明書やProvisioning Profileを不用意に削除すると他のプロジェクトへ影響する場合があります。

まとめ

Xcodeの「Upload failed」は、App Store Connectへのアップロードが完了しなかったことを示す総合的なエラーです。まずOrganizerの詳細ログを確認し、Build番号、署名設定、Apple ID、Archive、ネットワークの順に切り分けると原因を特定しやすくなります。特に証明書や設定を変更した後は、新しいArchiveを作成してから再アップロードするのが重要です。