この記事の要点

Build failed — まず Issue Navigator で具体的なエラーを確認。コマンドライン: xcodebuild でも詳細出力 Provisioning profile not found — Signing & Capabilities → Team 選択 + Automatic Sign Code signing error — 証明書期限切れ / Keychain 不整合 → 「証明書を再ダウンロード」 Module not found — Swift Package Manager 同期失敗 → File → Packages → Reset Package Caches CocoaPods sync error — pod deintegrate → pod install Clean Build Folder (Cmd+Shift+K) と DerivedData 削除は万能薬

Xcode でよく遭遇するエラー一覧

Xcode のエラーは数百種類ありますが、実務で頻出するのは 10〜15 種類程度。本記事ではそれらの原因と対処法をまとめます。

1. Build failed

最も漠然としたエラー。Issue Navigator (Cmd + 5) でツリーを展開し、根本のエラーを特定します。

# コマンドラインからビルドして詳細出力
xcodebuild -workspace MyApp.xcworkspace \
           -scheme MyApp \
           -configuration Debug \
           -sdk iphonesimulator \
           clean build | xcpretty

# xcpretty (gem install xcpretty) で整形

# 詳細ログ
xcodebuild ... -verbose

2. Provisioning profile not found

No matching provisioning profiles found
The provisioning profile specified in your build settings ("XXX") could not be found.

対処:

1. プロジェクト設定 → Signing & Capabilities
2. Team を選択 (Apple Developer 登録要)
3. Automatically manage signing をオン
4. Xcode → Settings → Accounts → Download Manual Profiles

または Apple Developer ポータル (developer.apple.com) で手動再生成し、ダウンロードしてダブルクリック。

3. Code signing error

Code Signing Error: No signing certificate "iOS Distribution" found.
Code Signing Error: No code signing identity found.

# Keychain Access (キーチェーンアクセス) を開く
open /System/Applications/Utilities/Keychain\ Access.app

# 「ログイン」キーチェーンで証明書一覧確認
# 期限切れ証明書は赤バツ → 削除

# Apple Developer から再ダウンロード:
# https://developer.apple.com/account/resources/certificates
# .cer をダブルクリック → Keychain に追加

# Xcode 再起動して再ビルド

4. Module 'XXX' not found

import Alamofire
^~~~~~
No such module 'Alamofire'

Swift Package Manager の場合:

1. File → Packages → Resolve Package Versions
2. File → Packages → Reset Package Caches
3. ~/Library/Caches/org.swift.swiftpm を削除
4. Xcode → Settings → Locations → Derived Data の 矢印アイコンで開いて削除

CocoaPods の場合:

cd MyApp/
pod deintegrate
pod cache clean --all
pod install

# あるいは
pod repo update
pod install --repo-update

# .xcodeproj ではなく .xcworkspace を開いているか確認
open MyApp.xcworkspace

5. Multiple commands produce / duplicate symbol

Multiple commands produce '/path/to/MyApp.app/Info.plist'
duplicate symbol '_OBJC_CLASS_$_XXX' in:

原因と対処:

• 同じファイルが Build Phases の Copy Bundle Resources に重複 → 重複削除
• 静的ライブラリが二重リンク → Frameworks & Libraries で重複削除
• Info.plist を Resources に手動追加している → 削除 (Xcode が自動コピー)

6. Simulator が起動しない

# Simulator アプリを完全終了
killall Simulator

# CoreSimulator サービス再起動
sudo killall -9 com.apple.CoreSimulator.CoreSimulatorService

# シミュレータを消して再作成
xcrun simctl shutdown all
xcrun simctl erase all

# 全シミュレータ一覧
xcrun simctl list

# 指定シミュレータ起動
xcrun simctl boot "iPhone 15 Pro"
open -a Simulator

# Xcode 再起動
killall Xcode
open -a Xcode

7. xcode-select 関連

xcrun: error: invalid active developer path (/Library/Developer/CommandLineTools),
missing xcrun at: /Library/Developer/CommandLineTools/usr/bin/xcrun

# Command Line Tools インストール
xcode-select --install

# Xcode 本体側に切替
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

# 現在のパス確認
xcode-select -p

# ライセンス同意
sudo xcodebuild -license accept

8. Clean Build Folder と DerivedData

Xcode の挙動が怪しいとき最初に試す:

# Xcode 内
# Product → Clean Build Folder (Cmd + Shift + K)

# DerivedData 削除
rm -rf ~/Library/Developer/Xcode/DerivedData/*

# Module キャッシュ
rm -rf ~/Library/Developer/Xcode/DerivedData
rm -rf ~/Library/Caches/com.apple.dt.Xcode

# SPM キャッシュ
rm -rf ~/Library/Caches/org.swift.swiftpm

# CocoaPods キャッシュ
pod cache clean --all

9. App Store Connect 提出時のエラー (ガイドライン)

エラー	対処
ITMS-90683 (Missing purpose string)	Info.plist に位置情報/カメラの説明文 (Usage Description) 追加
ITMS-90809 (UIWebView deprecated)	UIWebView を WKWebView に置換
ITMS-90478 (Invalid bundle identifier)	Bundle ID が App Store Connect 登録と一致するか確認
Guideline 2.1 (Performance: Crashes)	クラッシュログを Organizer で確認、修正
Guideline 4.0 (Design)	iOS HIG 準拠、明らかな表示崩れを修正
Guideline 5.1.1 (Privacy)	プライバシーポリシー URL、データ利用説明

10. Swift Compile Error の罠

• Type 'X' has no member 'Y' — typo、または import 不足。import Foundation / import UIKit 確認
• Cannot convert value of type 'String' to expected argument type 'Int' — 型変換不足。Int(str) ?? 0
• Variable used within its own initial value — 自己参照初期化。lazy var 化
• Closure containing a declaration cannot be used with result builder — ViewBuilder 内で let 使用 → 関数分離
• The compiler is unable to type-check this expression in reasonable time — 式が複雑すぎ。途中で型注釈を入れて分割

万能薬チェックリスト

1. Clean Build Folder (Cmd + Shift + K)
2. DerivedData 削除
3. Xcode 再起動
4. Mac 再起動
5. Xcode 再インストール (最終手段、大型版もあり)
6. Command Line Tools 再インストール
7. iOS シミュレータのErase All Content and Settings

FAQ

Q: Xcode のバージョンが古くて App Store 提出できない
A: App Store Connect は最低 Xcode バージョンを定期的に上げます。最新版にアップデート (要 macOS バージョン)。

Q: ビルドはできるが実機にインストールできない
A: Provisioning Profile に該当デバイス UDID が登録されているか確認。Developer Portal で Devices 追加。

Q: SwiftUI Preview が動かない
A: Editor → Canvas → Resume。または DerivedData クリアで多くは解決。プレビュー専用のクラッシュログは右下の Issue ボタン。

Q: Xcode 起動が遅い
A: ~/Library/Developer/Xcode/iOS DeviceSupport の古い iOS バージョン削除、Spotlight インデックスから DerivedData 除外。