👋

bundle install で発生する mysql2 のインストールエラー対処法

2023/12/28に公開

はじめに

bundle install 実行時に、mysql2 のインストールに失敗しました。

問題

色々な例があると思いますが、自分の場合は zstd の Path がうまく通っておらず、下記のエラーが出ていました。

...
ld: library 'zstd' not found
...

解決方法

下記を実行することで、成功しました。

export LIBRARY_PATH=$LIBRARY_PATH:$(brew --prefix zstd)/lib/

今後同様のエラーが発生しないように、~/.zshrc に追記しておくのがおすすめです。

LIBRARY_PATH とは

Unix 系のオペレーティングシステム(Linux や macOS など)において、コンパイラが共有ライブラリを探すために参照する環境変数のこと。

Zstd とは

可逆式圧縮を可能とするライブラリ。

おわりに

mysql2 関連エラーはデバッグに時間がかかって大変です。

参考

bundle install fails with Gem::Ext::BuildError · Issue #1175 · brianmario/mysql2 · GitHub

【Rails】mysql2のインストールができない場合の対処法【MySQL】 #Rails - Qiita

[Rails]初のbundle installでmysql2のエラーが出た時の解決策をまとめてみた #Rails - Qiita

Zstandard - Wikipedia

GitHubで編集を提案

Discussion