Ruby KeyError の原因と解決法

Hash#fetchで存在しないキーを指定すると発生するエラーです。キーのタイポと、シンボル・文字列の混同が2大原因です。

このエラーメッセージ

原因

• キーをタイプミスしている（:adress → :address）
• シンボル（:name）と文字列（"name"）を混同している
• データによってはキーが存在しないケースを想定していない

❌ エラーになるコード

user = { name: "太郎", address: "東京" }
puts user.fetch(:adress)  # キーのタイポ

✅ 修正したコード

user = { name: "太郎", address: "東京" }
puts user.fetch(:address)

# キーがない可能性があるならデフォルト値を指定
puts user.fetch(:phone, "未登録")

解決のポイント

まずキーのつづりと、シンボルか文字列か（:nameと"name"は別のキー）を確認します。存在しない可能性のあるキーにはfetch(:key, デフォルト値)で第2引数を渡すと、エラーではなく代替値が返ります。user.keysで実際のキー一覧を出力してみるのも早道です。

よくある質問