Swift 6.2の所有権エラーはどう直す?既存プロジェクトの緊急対応ガイド(2026)

Swift 6.2の所有権エラーは、先に実際のSwiftコンパイラ版・言語モード・診断全文を確認し、値のコピー可否と後続利用、APIの契約に沿って直してください。対象は、ツールチェーン更新後にビルドが止まった大型iOSアプリです。すべてのエラーをconsumingに変えたり、ARCを前提とする既存コードを一括で書き換えたりする必要はありません。
Swiftツールチェーンの更新を担い、ビルド回帰を抑えたい技術責任者向けです。
borrowing、consuming、Copyableの診断を追う開発者や、公開API・複数モジュールの互換性を判断するアーキテクトにも役立ちます。
診断の切り分けでは、所有権と環境不一致を分ける
まず、失敗したターゲットで使われているXcode、Swiftコンパイラ、Swift言語モード、完全な診断文を記録します。Xcodeの版だけでは、対象ターゲットがどの言語モードやビルド設定でコンパイルされているか判断できません。AppleのXcodeリリースノートとビルド設定のリファレンスを照合し、実際のターゲット設定を確認してください。
失敗がプロジェクト全体なのか、特定のSwift Packageや生成コードに限られるのかも分けます。所有権診断、ジェネリック制約の不一致、依存パッケージのツールチェーン非対応は、同時期に発生しても原因は別です。
| 診断の現れ方 | 最初に調べる場所 | 先に避ける対処 |
|---|---|---|
| 値がすでに消費された、または再利用できない | 診断された値の宣言から、その後の利用箇所まで | 利用箇所を追わずにconsumingを追加する |
型がCopyableを満たさない |
型宣言、ジェネリック引数、プロトコル要件 | 制約を見ずに呼び出し側だけ変更する |
| 一部ターゲットだけ失敗する | ターゲット別の言語モード、依存関係、生成コード | 全ターゲットを一括で書き換える |
再現は、失敗するターゲットと最小の呼び出し経路に絞ります。診断文が示す型名やジェネリック制約を控え、ビルド設定を確認してから、そのエラーだけが残る状態を作ると、ツールチェーン不一致との混同を防げます。
値の再利用では、先にライフサイクルを追う
「値を消費できない」「消費後に使えない」といった診断では、値が最初に所有権を渡す位置と、後で再利用される位置を特定します。関数呼び出しだけでなく、条件分岐の片側、クロージャーへの捕捉、エラー処理の経路も追跡します。
修正は、型の意味と利用者の期待で選びます。後続処理でも値が必要なら、関数が借用する契約にできるか検討します。呼び出し先が値を引き受け、呼び出し元での再利用が不要なら、消費が契約に合う場合があります。型がコピー可能で、別の値として使うことが意味上正しいケースでは、明示的なコピーも候補です。どの診断にも通用する一律の置換はありません。
たとえば大型アプリで、キャッシュ用の値を処理関数に渡した後、ログ出力でも同じ値を参照するケースがあります。呼び出し先が読み取りだけをするなら、APIを借用契約にできるかを確認します。値の所有権を移す設計なら、ログ側の利用を先に済ませるなど、意図する順序に呼び出し経路を整理します。単に診断を消すために型の性質を変えるのは避けます。
borrowingとconsumingは、関数の契約で選ぶ
borrowingは呼び出し中に値を借りる関係、consumingは関数側が値の所有権を引き受ける関係を表します。これらの引数修飾子はSE-0377で定義されています。consume操作の意味はSE-0366を参照してください。
| 関数の意図 | 検討する契約 | 呼び出し側の確認点 |
|---|---|---|
| 値を読み取るだけで、呼び出し元でも使う | borrowing |
呼び出し後の利用が必要か |
| 値を受け取り、呼び出し元での再利用を前提にしない | consuming |
所有権移転がAPIの意図と一致するか |
| 値を別の独立した値として扱う | 型が許す場合はコピー | コピーが型の意味に合うか |
公開フレームワークや複数モジュールで引数の所有権を変える前には、呼び出し元のソース、依存パッケージ、ABI互換性を調べます。公開シグネチャの変更は、ひとつのコンパイルエラーだけでなく、利用側のビルドや配布条件にも影響し得ます。APIを変える場合は、変更前後の互換性を別項目としてレビューしてください。
borrowingやconsumingを追加する前に、値の後続利用と公開APIの契約を記録してください。修正箇所が一つでも、呼び出し元が複数モジュールに広がるなら、影響範囲は一箇所とは限りません。
Copyableの衝突では、型から制約へたどる
Copyableのエラーは、具体型がコピー可能かどうかだけでなく、ジェネリックAPIがどの制約を要求しているかで変わります。調査は具体型、ジェネリック引数、プロトコル要件、値を保持するコンテナーの順に進めます。Swiftのジェネリックに関する言語ガイドも、型引数と制約の関係を確認する手掛かりになります。
SE-0390は非コピー可能な構造体・列挙型を扱い、SE-0427は非コピー可能型を含むジェネリックの扱いを定めています。したがって、エラーを見ただけで「呼び出し側の型が悪い」とも「非コピー可能型にすべき」とも決められません。ジェネリック側が必要とする条件を正しく表しているか確認します。
コピー可能な型を期待するインターフェースに、非コピー可能な型を渡しているなら、型の設計とAPIの期待が食い違っている可能性があります。反対に、非コピー可能型を許せる処理なのに制約が表現されていない場合は、ジェネリック境界やプロトコル要件を見直します。制約を外せば解決するとは限らず、関数内で値を複製する処理がないかも確認が必要です。
大型プロジェクトでは、同じ原因ごとに変更を広げる
エラー一覧をモジュール別・診断別に整理し、代表的な呼び出し経路で修正を検証してから、同じパターンへ展開します。共通基盤、アプリ本体、Swift Package、生成コードでは、ビルド設定や言語モードが一致しているとは限りません。Appleのビルド設定資料に沿って、ターゲットごとの差を記録します。
| 修正の進め方 | 利点 | 注意点 |
|---|---|---|
| 診断ごとに小さく変更する | 原因と差分を対応させやすい | 似た箇所の見落としを防ぐ一覧が必要 |
| 共通APIの契約を見直す | 複数の呼び出し箇所を一貫して扱える | 利用側と互換性の確認範囲が広がる |
| 全モジュールをまとめて変更する | 作業を一度に終えたように見える | 回帰原因と切り戻し箇所を特定しにくい |
Swiftのコンパイラ資料で利用可能なコンパイラ情報を確認し、CIとローカルの環境差も記録します。並行して別種の診断が出た場合は、所有権問題と決めつけず、該当ターゲットの依存関係や設定を切り分けます。Swift 6の並行処理に関する移行判断は、所有権診断とは別にデータ競合安全性の移行ガイドで確認してください。
マージ前の確認項目
変更をまとめて取り込むのではなく、モジュール単位でコミットし、再現手順と切り戻し点を残します。次の項目を満たした変更から、同一パターンの箇所へ適用します。
- [ ] Xcode、Swiftコンパイラ、ターゲットの言語モード、完全な診断文を記録した
- [ ] 最小の失敗ターゲットで再現し、依存関係や生成コードの設定差を確認した
- [ ] 値の初回消費位置と、分岐・クロージャーを含む後続利用を追った
- [ ]
borrowing、consuming、コピーのうち、型とAPI契約に合う選択肢を説明できる - [ ]
Copyableの要件を具体型からジェネリック境界まで確認した - [ ] 公開APIの呼び出し元、モジュール境界、互換性を確認した
- [ ] ビルドに加え、エラー経路やクロージャー捕捉を含む関連テストを実行した
- [ ] 変更単位、CI結果、切り戻し方法を記録した
非コピー可能設計は、値を複製できないという要件が本当にある場合に選びます。性能向上やARCの置き換えを、測定していない段階で修正の効果として扱わないでください。
よくある診断への回答
値が消費されたという診断が出た場合
まず、診断対象の値を後で使う箇所があるかを確認します。後続利用があるなら借用や処理順を検討し、所有権を渡す設計なら呼び出し側での再利用をなくすなど、意図に沿って修正します。値がコピー可能かどうかも型から確認してください。
borrowとconsumeの選択基準
関数が値を読むだけで呼び出し元にも残すなら、借用が候補です。所有権を引き受け、呼び出し元では使わない契約なら消費を検討します。公開APIでは、既存の呼び出し元と互換性を先に確認します。
Copyableのエラーが出た場合
具体型の性質とジェネリック制約を順に調べます。型が非コピー可能であるべきか、APIがその型を許すべきかを区別してください。制約が不足している場合と、呼び出し側の型が要求に合わない場合では、直す場所が異なります。
プロジェクト全体を非コピー可能型にすべきか
全体変更は必要ありません。非コピー可能型は必要な箇所だけに適用し、既存の型やARC利用を一律に変更しない方針が安全です。Swiftの所有権機能を、アプリ全体のメモリー管理方式の置き換えとして扱わないでください。
ローカル環境だけで大規模な再現ビルドを続けると、他の開発作業との競合や環境差の管理が負担になります。一方、常時走る重いビルドや物理デバイス接続が欠かせない開発では、手元のMacや専用環境のほうが向く場合があります。切り分け用に一時的なXcode環境を分けたいなら、ProxyMacの利用案内やコンソールを確認し、料金情報と必要な利用条件を照らし合わせてください。レンタルMacはビルド環境の分離には使えますが、Swiftの型エラーそのものを修正するものではありません。