macOS Mojave環境でmysql2(0.5.2)のgemインストールが失敗した

6218 ワード
RubyOnRails5.2 Ruby2.3.1 macOSMojave Ruby2.3.1 テキストリンク

はじめに

久しぶりにRailsの勉強をしようと思い、rails newで最新版のRailsアプリケーションを作成しようとしたところ、「mysql2のv0.5.2がインストールされていない」旨のエラーがでましたのでこれを解消しようとしました。

*追記（2020.3.2）

bundle installでmysql2インストールが失敗したので、こちらの記事を参考にして解決しました！
RailsにMySQLを導入したらかなりハマった件について - 大学生Webエンジニアの記録 -
【Rails】MySQL2がbundle installできない時の対応方法 - Qiita -

事象

ターミナルからgem install mysql2 -v 0.5.2を実行したところ、以下のようなエラーが出ました

Building native extensions. This could take a while...
ERROR:  Error installing mysql2:
    ERROR: Failed to build gem native extension.

    current directory: /Users/nagative/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/mysql2-0.5.2/ext/mysql2
/Users/nagative/.rbenv/versions/2.3.1/bin/ruby -r ./siteconf20181216-4593-p47yfi.rb extconf.rb
checking for rb_absint_size()... yes
checking for rb_absint_singlebit_p()... yes
checking for rb_wait_for_single_fd()... yes
-----
Using mysql_config at /usr/local/bin/mysql_config
-----
checking for mysql.h... yes
checking for errmsg.h... yes
checking for SSL_MODE_DISABLED in mysql.h... yes
checking for SSL_MODE_PREFERRED in mysql.h... yes
checking for SSL_MODE_REQUIRED in mysql.h... yes
checking for SSL_MODE_VERIFY_CA in mysql.h... yes
checking for SSL_MODE_VERIFY_IDENTITY in mysql.h... yes
checking for MYSQL.net.vio in mysql.h... yes
checking for MYSQL.net.pvio in mysql.h... no
checking for MYSQL_ENABLE_CLEARTEXT_PLUGIN in mysql.h... yes
checking for SERVER_QUERY_NO_GOOD_INDEX_USED in mysql.h... yes
checking for SERVER_QUERY_NO_INDEX_USED in mysql.h... yes
checking for SERVER_QUERY_WAS_SLOW in mysql.h... yes
checking for MYSQL_OPTION_MULTI_STATEMENTS_ON in mysql.h... yes
checking for MYSQL_OPTION_MULTI_STATEMENTS_OFF in mysql.h... yes
checking for my_bool in mysql.h... yes
-----
Don't know how to set rpath on your system, if MySQL libraries are not in path mysql2 may not load
-----
-----
Setting libpath to /usr/local/Cellar/mysql/5.7.21/lib
-----
creating Makefile

current directory: /Users/nagative/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/mysql2-0.5.2/ext/mysql2
make "DESTDIR=" clean

current directory: /Users/nagative/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/mysql2-0.5.2/ext/mysql2
make "DESTDIR="
compiling infile.c
compiling client.c
compiling mysql2_ext.c
compiling statement.c
compiling result.c
linking shared-object mysql2/mysql2.bundle
ld: library not found for -lssl
clang: error: linker command failed with exit code 1 (use -v to see invocation)
make: *** [mysql2.bundle] Error 1

make failed, exit code 2

Gem files will remain installed in /Users/nagative/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/gems/mysql2-0.5.2 for inspection.
Results logged to /Users/nagative/.rbenv/versions/2.3.1/lib/ruby/gems/2.3.0/extensions/x86_64-darwin-17/2.3.0-static/mysql2-0.5.2/gem_make.out

原因

エラーを見ていくと

ld: library not found for -lssl
clang: error: linker command failed with exit code 1 (use -v to see invocation)

とのこと。
sslのライブラリが見つからないということなので、色々と調べて以下を試してみました。

試した事

1. opensslのインストール（アップグレード）

自分のPCにはすでにopensslがbrew経由でインストールされているので、opensslが最新かどうかbrew outdatedコマンドをターミナルで確認します。するとopenssl (1.0.2o_1) < 1.0.2qと表示されたので、brew upgrade opensslコマンドで（一応）アップグレードしました。

＊補足

自分の場合、mysqlのバージョンも古かったせいか、opensslのアップデートに合わせてmysqlも一緒にアップグレードされました。。。

2. XCode select toolsのインストール（アップグレード）

githubで公開されているmysql2のREADMEを確認すると、xcode-select --installコマンドをターミナルで実行して、XCode select toolsをインストールする必要があると記載がありました。自分のPCにはすでにXCode select toolsがインストールされていましたが、バージョンが古い可能性があったので、再度コマンドを実行して最新版にアップグレードしました。

3. オプションを指定して、mysql2をインストール（解決策）

再度gem install mysql2 -v 0.5.2を実行しましたが解消されなかったため、調べ直したところオプションコマンドを追加することで解消するとのこと。（GitHubGistサイト参照）

gem install mysql2 -v '0.5.2' -- --with-ldflags=-L/usr/local/opt/openssl/lib --with-cppflags=-I/usr/local/opt/openssl/include

コマンドを入力して再度実行してみると・・・

This could take a while...
Successfully installed mysql2-0.5.2
Parsing documentation for mysql2-0.5.2
Installing ri documentation for mysql2-0.5.2
Done installing documentation for mysql2 after 0 seconds
1 gem installed

成　功　し　ま　し　た　！

念の為、gem listコマンドでインストールされたか確認してみると

*** LOCAL GEMS ***
・・・
・・・
mysql2 (0.5.2, 0.5.1, 0.4.10, 0.4.5, 0.3.21, 0.3.20, 0.3.18)

v0.5.2がインストールされていることが確認できます。

おわりに

しばらくRailsをいじっていなかったので、コマンドがわからず四苦八苦しましたが、なんとか解決できてよかったです。。。

参考にしたサイト

Install mysql2 on MacOS Mojave - GitHubGist -
brianmario/mysql2 - GitHub -