ld: symbol(s) not found for architecture x86_64 – Errorの解決方法【2025年最新版】

エラーの概要・症状

このエラーメッセージ「ld: symbol(s) not found for architecture x86_64」は、主にXcodeを使用している際に発生します。具体的には、アプリケーションやライブラリのビルド時に、必要なシンボルが見つからない場合に表示されます。このエラーは、主に以下のような状況で発生します。

• プロジェクトが依存するフレームワークやライブラリが正しくリンクされていない場合。
• 使用しているライブラリがx86_64アーキテクチャに対応していない場合。
• 必要なソースファイルやヘッダーファイルがプロジェクトに追加されていない場合。

このエラーが発生すると、アプリケーションのビルドが成功しないため、開発作業が一時的に停止してしまいます。特に、初心者の開発者にとっては、エラーの原因を特定することが難しく、時間を浪費することも少なくありません。ここでは、このエラーを解決するための具体的な手順を紹介します。

このエラーが発生する原因

「ld: symbol(s) not found for architecture x86_64」エラーの主な原因は、以下の通りです。

1. フレームワークやライブラリの未リンク: プロジェクトで使用するフレームワーク（例: IOBluetooth.framework）が、ビルド設定で正しくリンクされていない場合、シンボルが見つからないというエラーが発生します。

• 技術的背景: 特定のフレームワークがプロジェクトに含まれていないと、Xcodeはそのフレームワークに関連するシンボルを解決できなくなります。

1. アーキテクチャの不一致: 使用しているライブラリがx86_64アーキテクチャに対応していない場合、ビルド時にエラーが発生します。特に、古いライブラリやx32アーキテクチャ用にコンパイルされたライブラリは、x86_64環境では動作しません。

• 技術的背景: Appleは最新のXcodeバージョンでarm64アーキテクチャを推奨しており、古いアーキテクチャのライブラリは互換性がありません。

1. ソースファイルの不足: 必要なクラスやヘッダーファイルがプロジェクトに追加されていない場合も、シンボルが見つからないエラーが発生します。

• 技術的背景: プロジェクトに必要なファイルが存在しないと、コンパイラはそれに依存するコードを正しく解決できません。

1. CocoaPodsのキャッシュ問題: CocoaPodsを使用している場合、キャッシュが原因でエラーが生じることもあります。

• 技術的背景: Podが正しくインストールされていない、またはキャッシュが破損していると、必要なシンボルが見つからなくなることがあります。

解決方法1（最も効果的）

エラーを解決するための最も効果的な方法は、必要なフレームワークをプロジェクトに追加することです。以下の手順で行います。

手順1-1（具体的なステップ）

1. Xcodeを開き、左側のナビゲーターからプロジェクトを選択します（青いアイコン）。

2. 中央のペインで、「Build Phases」タブをクリックします。

3. 「Link Binary With Libraries」セクションを見つけ、プラスボタン（+）をクリックします。

4. 一覧からIOBluetooth.frameworkを探し、追加ボタンを押します。

手順1-2（詳細な操作方法）

これにより、IOBluetooth.frameworkがプロジェクトにリンクされ、必要なシンボルが解決されるはずです。プロジェクトをビルドし直して、エラーが解消されたか確認します。

注意点とトラブルシューティング

• もし追加したフレームワークが見つからない場合、macOSのバージョンを確認してください。最新のXcodeでは、古いフレームワークがサポートされていない場合があります。
• また、使用しているライブラリがx86_64アーキテクチャに対応しているかも確認してください。

解決方法2（代替手段）

もし上記の方法で解決しない場合は、プロジェクトのアーキテクチャ設定を変更することを検討します。以下の手順で行います。

1. Xcodeでプロジェクト設定を開きます。

2. 「Build Settings」タブをクリックします。

3. 「Architectures」セクションを探し、$(ARCHS_STANDARD)に設定します。これにより、Xcodeが標準のアーキテクチャを使用するようになります。

この設定を行った後、再度プロジェクトをビルドしてみてください。

解決方法3（上級者向け）

より技術的なアプローチとして、コマンドラインを使用してビルドを行う方法があります。以下の手順で行います。

1. ターミナルを開きます。

2. プロジェクトのルートディレクトリに移動します。

3. 以下のコマンドを入力してビルドを行います。

   xcodebuild -scheme YourSchemeName -configuration Debug

ここで、YourSchemeNameは実際のスキーム名に置き換えます。

この方法でビルドを行うことで、エラーメッセージが表示される場合は、詳細なログが表示されるため、問題の特定に役立ちます。

エラーの予防方法

エラーを未然に防ぐためには、以下の対策が有効です。

• プロジェクトのビルド設定を定期的に見直し、適切なフレームワークやライブラリがリンクされているか確認しましょう。
• 使用するライブラリが最新のアーキテクチャに対応しているか、公式ドキュメントで確認することが重要です。
• CocoaPodsを使用している場合、定期的にキャッシュをクリアし、依存関係を更新することをお勧めします。コマンドは以下の通りです。

  pod deintegrate && pod cache clean --all

関連するエラーと対処法

このエラーに関連する他のエラーも存在します。例えば、以下のようなエラーが考えられます。

• Undefined symbols for architecture arm64：arm64アーキテクチャに対応していないライブラリが原因で発生します。解決策は、該当ライブラリを更新することです。
• clang: error: linker command failed with exit code 1：リンク時に発生するエラーで、必要なフレームワークがリンクされていない場合に表示されます。フレームワークを確認して追加することで解決します。

まとめ

「ld: symbol(s) not found for architecture x86_64」エラーは、主にフレームワークの未リンクやアーキテクチャの不一致が原因で発生します。正しいフレームワークをリンクし、プロジェクトのビルド設定を見直すことで、問題を解決できます。エラーが解消されたら、次のステップとしてアプリのテストやデバッグを行いましょう。これにより、開発がスムーズに進むはずです。