DevOps / CI/CD

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

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の型エラーそのものを修正するものではありません。

FAQ

Cannot consume valueの診断が出たとき、最初に何を確認すればよいですか?+
表示された式だけを見て修飾子を追加せず、値が最初に消費される箇所と、その後に同じ値を使う箇所を追います。分岐やクロージャーへの捕捉も含め、実際のコンパイラ版と言語モードで再現してください。後続利用が必要なら借用や型設計を検討し、所有権を渡すのが意図どおりの場合にだけ消費を選びます。
関数の引数はborrowingとconsumingのどちらにすべきですか?+
関数の中で値を読み取るだけで、呼び出し元にもその値を残す契約ならborrowingが候補です。関数が値の所有権を引き受け、呼び出し元での再利用を前提としない契約ならconsumingを検討します。公開APIでは呼び出し元すべてへの影響とABI互換性を調べ、単一の診断を消す目的だけで変更しないことが重要です。
Copyableの制約エラーは型と呼び出し側のどちらを直すべきですか?+
まず具体型が非コピー可能として宣言されているかを調べ、次にジェネリック引数、プロトコル要件、コンテナーの順で制約を追います。型の性質に反してコピー可能と仮定するAPIなら型設計側を見直します。一方、型自体は適合可能なのにジェネリック関数の制約が表現不足なら、必要な要件をインターフェースに示す修正が候補です。
所有権エラーを解消するため、既存アプリ全体を非コピー可能型に変える必要がありますか?+
必要ありません。非コピー可能型は、値を複製できないという型の契約が必要な場所で使う設計です。既存の値型や参照型を一律に変更すると、API、ジェネリック制約、依存モジュールまで影響を広げます。診断が示すライフサイクルや制約を確認し、型の意味が変わらない修正を優先してください。所有権機能はARCをプロジェクト全体で置き換えるものではありません。

Swift 6.2の修正・検証に、専用Macを活用しませんか?

ProxyMacなら、専用のMac mini M4でSwiftのビルドや動作確認に取り組めます。
SSH・VNC・ブラウザーから接続でき、手元の環境に縛られず作業を進められます。