概要

ローカルの Ruby on Rails で bundle install を実行したときに、mysql2のインストールで以下のエラーが出てしまうことがあります。

Installing mysql2 0.5.6 with native extensions
Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

# (略)

Gem files will remain installed in
/Users/watasho/study/batch_sample/.bundle/ruby/3.2.0/gems/mysql2-0.5.6 for inspection.
Results logged to
/Users/watasho/study/batch_sample/.bundle/ruby/3.2.0/extensions/arm64-darwin-22/3.2.0/mysql2-0.5.6/gem_make.out

# (略)

An error occurred while installing mysql2 (0.5.6), and Bundler cannot continue.

In Gemfile:
  mysql2

本記事では、その場合の対処法についてまとめています。

結論

brewのmysqlのバージョンを8.3から8.0に下げることで解決。

解決方法

筆者の環境では、brewでmysqlをインストールしていたのですが、8.3がインストールされていました。

$ brew list | grep mysql

mysql-client@8.3
mysql@8.3

バージョン8.3の、上記mysqlクライアントとmysqlサーバーをアンインストールし、バージョン8.0の同様のものをインストールすることで、bundle install時にmysql2のインストールができるようになりました。

最近起きた問題のようです。

$ brew uninstall mysql-client@8.3
$ brew uninstall mysql@8.3

$ brew install mysql-client@8.0
$ brew uninstall mysql@8.0

参考サイト

https://github.com/brianmario/mysql2/issues/1346

https://github.com/brianmario/mysql2/releases/tag/0.5.6

株式会社PRUM佐渡では現在、仲間を大募集中！
PRUM佐渡での仕事は、自由な発想と、限界を決めない創造力から始まります。
やれることはまだまだあります。
さまざまなことに挑戦し、一緒に成長していきましょう！エントリーやお問い合わせは以下からお願いします。
採用ページはこちら

開発を検討されている企業様へ
貴社の課題を解決するためのシステムを受託開発します。どんなシステムを構築すればよいか分からない場合でも、プロジェクトマネージャーが丁寧にヒアリングを行い、要件を具体化します。以下よりお気軽にお問い合わせください！