devbox(Nix)環境でgo installすると発生する「Undefined symbols for architecture arm64」というmacOS特有のエラーはCGO_ENABLED=0を付けると解決するという話をします。

この投稿で学べること

問題: リンクエラーが発生する

devbox（Nix）環境のGoでgo installを実行すると、macOS/arm64で次のようなエラーに遭遇することがあります。

Undefined symbols for architecture arm64:
  _SecTrustCopyCertificateChain

このエラーは、cgoがAppleのSecurity.frameworkをリンクしようとする際、Nixのclang-wrapperやSDKとの相性問題で解決できずに発生します。

cgoを無効化すると、この問題は解決します。

コマンドラインでインストールする場合、次のようにCGO_ENABLED=0を付けて実行します。

CGO_ENABLED=0 go install <package>@<version>

例えば、kustomizeをインストールする場合は次のようになります。

CGO_ENABLED=0 GOBIN=./bin go install sigs.k8s.io/kustomize/kustomize/v5@v5.7.1

Makefile経由でインストールする場合も同様です。

CGO_ENABLED=0 make install

あるいは、ツール取得ターゲットだけcgoを切る方法もあります。

CGO_ENABLED=0 go install sigs.k8s.io/kustomize/kustomize/v5@$(KUSTOMIZE_VERSION)

ビルド自体を避ける方法として、devboxに直接パッケージを追加する選択肢もあります。

例えば、devbox add kustomizeを追加し、bin/kustomizeをPATH上の実体へシンボリックリンクすることで、ビルドプロセスそのものを回避できます。

アプリケーション本体でcgoが必要な場合は、そのビルド時にはCGO_ENABLED=1に戻す必要があります。

ポイントは、「ツールのgo installだけcgoを切る」という点です。これだけで、大抵の場合はすんなり通ります。

devbox環境でGoツールのインストール時にリンクエラーが出た場合、CGO_ENABLED=0を付けるだけで解決できます。この方法は、Nix特有のSDKやclang-wrapperとの相性問題を回避する、最も手軽な対処法になります。

最後までお読みくださりありがとうございました。Twitter では、Qiita に書かない技術ネタなどもツイートしているので、よかったらフォローしてもらえると嬉しいです→Twitter@suin