An error occurred while installing mysql2 (0.5.3)の対処法

 サイト訪問ありがとうございます!ミツオです。
今回の記事では、Ruby on Rails をMacPC にインストールしようとした時の次のエラーの対処法を説明しています。

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.

・Ruby on Rails をインストールしたくて他のサイトを参考にしてたけどエラー出た、、
・情報がありすぎてどれを信じていいかわからない


そんな悩みもこの記事を読めば解決することができます。
Ruby on Rails のMacPC へのわかりやすいインストール方法を知りたい方は次のリンクを押してください!

Ruby on Rails をMacPC にインストールする初心者にもわかりやすい方法

1. Rails をインストールしたい

 まずはエラーが起きた状況を確認していきましょう。
したいことは、MacPC にRuby on Rails をインストールすることです。
次のコマンドの実行は成功しています。

$ gem install rails

しかし、その後gem をインストールするための次のコマンドを実行すると
エラーが発生します。

$ bundle install --path vendor/bundle

その1つ前に実行しているはずの次のコマンドでも
インストールがうまくいっていないような記述が書かれています。

# Railsアプリの作成(gemのインストールはスキップ)
$ rails _6.0.3.3_ new . -d postgresql --skip-bundle
->Could not find gem 'mysql2 (>= 0.4.4)' in any of the gem sources listed in your Gemfile.
Run `bundle install` to install missing gems.

bundle install を実行するようにと書かれていますが、実行しても本記事で説明しているエラーが発生します。

2. An error occurred while installing mysql2 (0.5.3)

 原因となる箇所も含めてエラー内容を確認してみましょう。

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/<ユーザー名>/.rbenv/versions/2.7.1/lib/ruby/gems/2.7.0/gems/mysql2-0.5.3 for inspection.
Results logged to
/Users/<ユーザー名>/.rbenv/versions/2.7.1/lib/ruby/gems/2.7.0/extensions/x86_64-darwin-18/2.7.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.

library が見つからないようです。
詳しく書くとopensslのパスがビルドする時に追加しないといけないということです。

3. An error occurred while installing mysql2 (0.5.3) への対処法

 原因がわかったところで、対処していきましょう!
パスを指定していないことが原因だったので、パスを指定してbundler のインストールを実行します。

$ bundle config --local build.mysql2 "--with-ldflags=-L/usr/local/opt/openssl/lib"
$ bundle install

 Rails のバージョンを確認することでエラーを解消できたか確認してみましょう!

$ rails -v
Rails 6.0.3.3

エラーが解消したことが確認できました!

Rails のインストール方法に戻るには次のリンクを押してください。

Ruby on Rails をMacPC にインストールする初心者にもわかりやすい方法

まとめ 〜An error occurred while installing mysql2 (0.5.3) 解決〜

エラーは解消できましたか?
今回の記事が助けになれば幸いです!

Rails をインストールできたあとは、Rails サーバーを起動しないといけません。
しかし、Rails サーバーの起動のところでエラーが頻発します。
ぜひ次の記事も読んでRails サーバーの起動を成功させてください!

Rails サーバーを起動できない時の対処法

最後まで読んでくださってありがとうございました!