Ruby「Failed to build gem native extension」の原因と直し方
Failed to build gem native extension は、出力が名指しする足りない道具か開発用パッケージを入れれば直る。
C で書かれた部分を持つ gem は入れるときにコンパイルされ、make やヘッダが無いと止まる。
公開:
要約
gem install bcrypt や bundle install が、次のエラーで止まることがある。
ERROR: Error installing bcrypt:
ERROR: Failed to build gem native extension.Failed to build gem native extension は、gem に含まれる C の拡張ライブラリのビルドが失敗したという意味である。
そうした gem は、入れるときに extconf.rb で Makefile を作り、make でコンパイルする。
エラーの下に続く出力が足りないものを名指ししているので、それを入れて打ち直せば直る。
bundle install では、同じ失敗が Gem::Ext::BuildError: ERROR: Failed to build gem native extension. と出る。
最後は An error occurred while installing bcrypt (3.1.20), and Bundler cannot continue. で終わり、終了コードは 5 だった。
解決策
1. コンパイラと make を入れる
apt-get update
apt-get install -y build-essential
gem install bcrypt -v 3.1.20ruby:3.4-slim でこの順に打つと、Successfully installed bcrypt-3.1.20 と出て終了コード 0 で通った。
Dockerfile なら、bundle install より前の RUN で入れる。
2. Ruby のヘッダを入れる
apt-get install -y ruby-devDebian の ruby-dev(新しいタブで開く) は、Ruby の拡張ライブラリをコンパイルするためのヘッダのパッケージである。
Debian 13 では、build-essential に加えてこれを入れると bcrypt が入った。
エラーの案内は、OS によってパッケージ名が ruby-devel になることも添えている。
3. 名指しされたライブラリの開発用パッケージを入れる
apt-get install -y libmariadb-dev
gem install mysql2エラーの下には extconf.rb の出力が続き、何が見つからなかったかと mkmf.log の場所が出る。
To see why this extension failed to compile, please check the mkmf.log which can be found here:RubyGems のガイド(新しいタブで開く)によると、extconf.rb は拡張が頼る関数やライブラリを確かめ、足りなければエラーで終わる。
出力の最初の no の行を見れば、足りないものがわかる。
mysql2 では checking for -lmysqlclient... no だった。
よくある原因
makeやgccが無い。ruby:3.4-slimのイメージでgem install bcrypt -v 3.1.20を打つと、Makefile は作られたあとmake failedNo such file or directory - makeで止まった。- OS のパッケージで入れた Ruby に、Ruby のヘッダが無い。
Debian 13 でrubyだけを apt で入れると、mkmf.rb can't find header files for rubyと出て、ruby-devかruby-develを入れるよう案内される。 - gem が使う C のライブラリの開発用パッケージが無い。
gem install mysql2はmysql client is missing.と出し、libmariadb-devなどの名前を挙げて止まった。