RubyGems mysql2のbundle installでOpenSSLのライブラリのパスを指定する

RubyGems mysql2 のインストールには OpenSSL ライブラリが必要ですが、 bundle install 時にライブラリが見つからずにエラーになってしまうことがあります。

このエントリでは、OpenSSL のライブラリを探してパスを指定する方法をメモしておきます。

エラー内容

mysql2 のインストールに失敗したとき、下記のようなエラーが表示されます。

ここで注目すべきは --with-ldflags\=-L/usr/local/opt/openssl/lib の OpenSSL のライブラリの指定部分で、実際にそのパスが存在するか確認します。

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.
    current directory: /app/vendor/bundle/gems/mysql2-0.5.3/ext/mysql2
/usr/local/bin/ruby -I /usr/local/lib/ruby/2.6.0 -r
./siteconf20210702-7-1nnt2f1.rb extconf.rb
--with-ldflags\=-L/usr/local/opt/openssl/lib\
--with-cppflags\=-I/usr/local/opt/openssl/include
checking for rb_absint_size()... *** extconf.rb failed ***
Could not create Makefile due to some reason, probably lack of necessary
libraries and/or headers.  Check the mkmf.log file for more details.  You may
need configuration options.
Provided configuration options:
      --with-opt-dir
      --without-opt-dir
      --with-opt-include
      --without-opt-include=${opt-dir}/include
      --with-opt-lib
      --without-opt-lib=${opt-dir}/lib
      --with-make-prog
      --without-make-prog
      --srcdir=.
      --curdir
      --ruby=/usr/local/bin/$(RUBY_BASE_NAME)
/usr/local/lib/ruby/2.6.0/mkmf.rb:467:in `try_do': The compiler failed to
generate an executable file. (RuntimeError)
You have to install development tools first.
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:552:in `try_link0'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:570:in `try_link'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:782:in `try_func'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:1069:in `block in have_func'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:959:in `block in checking_for'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:361:in `block (2 levels) in postpone'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:331:in `open'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:361:in `block in postpone'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:331:in `open'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:357:in `postpone'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:958:in `checking_for'
      from /usr/local/lib/ruby/2.6.0/mkmf.rb:1068:in `have_func'
      from extconf.rb:25:in `<main>'
To see why this extension failed to compile, please check the mkmf.log which can
be found here:
  /app/vendor/bundle/extensions/x86_64-linux/2.6.0/mysql2-0.5.3/mkmf.log
extconf failed, exit code 1
Gem files will remain installed in /app/vendor/bundle/gems/mysql2-0.5.3 for
inspection.
Results logged to
/app/vendor/bundle/extensions/x86_64-linux/2.6.0/mysql2-0.5.3/gem_make.out
An error occurred while installing mysql2 (0.5.3), and Bundler cannot continue.
Make sure that `gem install mysql2 -v '0.5.3' --source 'https://rubygems.org/'`
succeeds before bundling.
In Gemfile:
  mysql2

もしパスが存在しなければ、ライブラリが見つからないことによるエラーです。

$ ls /usr/local/opt/openssl/lib
ls: cannot access '/usr/local/opt/openssl/lib': No such file or directory

OpenSSLのライブラリを探す

find コマンドを使って OpenSSL のライブラリを探します。

find / -name '*libssl*'

libssl.a や libssl.so といったファイルが見つかれば、そのディレクトリのパスを bundle config に指定して bundle install します。

bundle config build.mysql2 "--with-ldflags=-L/usr/lib/x86_64-linux-gnu/"
bundle install

もし libssl.a などのファイルが見つからなければ OpenSSL がインストールされていません。

その場合はOSごとの方法で OpenSSL をインストールします。

下記は Debian の例です。

apt-get update -y && apt-get install -y libssl-dev

以上です。

エラー内容

OpenSSLのライブラリを探す

コメントを送る