できない.dev

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.20

ruby:3.4-slim でこの順に打つと、Successfully installed bcrypt-3.1.20 と出て終了コード 0 で通った。
Dockerfile なら、bundle install より前の RUN で入れる。

2. Ruby のヘッダを入れる

apt-get install -y ruby-dev

Debian の 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 だった。

よくある原因

  1. make や gcc が無い。
    ruby:3.4-slim のイメージで gem install bcrypt -v 3.1.20 を打つと、Makefile は作られたあと make failedNo such file or directory - make で止まった。
  2. OS のパッケージで入れた Ruby に、Ruby のヘッダが無い。
    Debian 13 で ruby だけを apt で入れると、mkmf.rb can't find header files for ruby と出て、ruby-dev か ruby-devel を入れるよう案内される。
  3. gem が使う C のライブラリの開発用パッケージが無い。
    gem install mysql2 は mysql client is missing. と出し、libmariadb-dev などの名前を挙げて止まった。