Ruby NoMethodError: undefined method の原因と解決方法

NoMethodError: undefined method とは

Rubyで「NoMethodError: undefined method ‘xxx’ for yyy」は最も頻繁に遭遇するエラーの一つです。存在しないメソッドを呼び出した場合や、nilに対してメソッドを呼び出した場合に発生します。特にRuby on Railsの開発で頻出するエラーです。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: nilに対するメソッド呼び出し

user = nil
puts user.name
# NoMethodError: undefined method 'name' for nil:NilClass

userがnilの状態でnameメソッドを呼び出しているためエラーが発生します。nilに対するメソッド呼び出しはRubyで最も多いNoMethodErrorの原因です。

# 修正例1: nilチェック
if user
  puts user.name
end

# 修正例2: ぼっち演算子（&.）
puts user&.name

# 修正例3: デフォルト値
puts user&.name || "不明"

パターン2: メソッド名のスペルミス

items = [3, 1, 2]
items.legth
# NoMethodError: undefined method 'legth' for [3, 1, 2]:Array
# Did you mean? length

lengthの綴りがlegthと間違っているため、存在しないメソッドの呼び出しとなります。Ruby 2.3以降では「Did you mean?」で候補を提示してくれます。

# 修正: 正しいメソッド名を使用
items = [3, 1, 2]
puts items.length  # => 3

パターン3: 異なるクラスのメソッドを呼び出し

number = 42
number.push(10)
# NoMethodError: undefined method 'push' for 42:Integer

pushはArrayクラスのメソッドであり、Integerクラスには存在しません。変数の型が意図したクラスと異なっている場合にこのエラーが発生します。

# 修正: 正しいクラスのオブジェクトに対してメソッドを呼び出す
numbers = [42]
numbers.push(10)
puts numbers  # => [42, 10]

根本原因の特定方法

エラーメッセージの「for yyy:ClassName」の部分でオブジェクトのクラスを確認します。NilClassと表示されている場合は、そのオブジェクトがnilになっている原因を遡って調査します。irbやpryを使ってオブジェクトの状態を対話的に確認するのが効果的です。

# デバッグ例
puts user.class   # => NilClass（nilの場合）
puts user.inspect  # => nil

# pryを使った対話的デバッグ
# require 'pry'; binding.pry をエラー箇所の前に挿入

防止策とベストプラクティス

NoMethodErrorを防ぐには、nilの可能性があるオブジェクトにはぼっち演算子（&.）を使い、メソッド呼び出し前にrespond_to?で確認する方法も有効です。型を意識したコーディングを心がけましょう。

# 防止策まとめ
# 1. ぼっち演算子（&.）
name = user&.name

# 2. respond_to? でメソッドの存在確認
if obj.respond_to?(:name)
  puts obj.name
end

# 3. nilガード
user ||= User.new

# 4. dig メソッド（ネストしたハッシュ）
data = { user: { address: { city: "Tokyo" } } }
city = data.dig(:user, :address, :city)

Stack Overflowでの質問状況

Stack Overflowでは、Rubyに関する質問が約229,371件投稿されており、NoMethodError: undefined methodは最も頻繁に質問されるエラーカテゴリの一つです。

よくある質問（FAQ）