Railsチュートリアルのnokogiriのインストールでコケた時の対処法

Ruby on Rails

Railsチュートリアルを進めていて3.1でnokogiriのインストールでコケたのでその対処法をまとめました。

発生したバージョン

ruby 2.1.2p95
Rails 4.0.5
nokogiri 1.6.2.1

bundle updateの結果

bundle updateでの結果nokogiriのインストールでコケた

$ bundle update
Fetching gem metadata from https://rubygems.org/.........
Fetching additional metadata from https://rubygems.org/..
Resolving dependencies...
Using rake 10.3.2
~~~
省略
~~~
Building nokogiri using packaged libraries.

Gem::Ext::BuildError: ERROR: Failed to build gem native extension.

    /Users/akinov/.rbenv/versions/2.1.2/bin/ruby extconf.rb 
Building nokogiri using packaged libraries.
-----
libiconv is missing.  please visit http://nokogiri.org/tutorials/installing_nokogiri.html for help with installing dependencies.
-----
*** 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.
~~~
省略
~~~
extconf failed, exit code 1

Gem files will remain installed in /Users/akinov/.rbenv/versions/2.1.2/lib/ruby/gems/2.1.0/gems/nokogiri-1.6.2.1 for inspection.
Results logged to /Users/akinov/.rbenv/versions/2.1.2/lib/ruby/gems/2.1.0/extensions/x86_64-darwin-13/2.1.0-static/nokogiri-1.6.2.1/gem_make.out
An error occurred while installing nokogiri (1.6.2.1), and Bundler cannot continue.
Make sure that `gem install nokogiri -v '1.6.2.1'` succeeds before bundling.

対処法

以下のブログを参考にGemfileを修正 Ruby - Nokogiri 1.6.0 のインストールが遅い件とその解決方法 - Qiita

ENV['NOKOGIRI_USE_SYSTEM_LIBRARIES'] = 'YES'
gem 'nokogiri', '1.6.0'

これでbundle updateしてもnokogiriのインストールでコケることはなくなりました。