Railsのエラー『ActiveModel::UnknownAttributeError: unknown attribute ‘X’』の解決方法

Railsで「ActiveModel::UnknownAttributeError: unknown attribute ‘X’」が発生する原因と解決策を解説する。このエラーは、データベースのカラムに存在しない属性をモデルに渡した際に発生する。発生条件や調査方法、具体的な対応策をコード付きで説明する。

エラーの発生条件

このエラーは、以下のような状況で発生する。

• モデルに定義されていない属性をcreateやupdateで渡している
• マイグレーションを適用していない（rails db:migrate が未実行）
• Strong Parametersで許可されていないパラメータを渡している
• フォームのフィールド名が誤っている

エラーの発生例

例えば、以下のコードを実行するとエラーが発生する。

class User < ApplicationRecord
end

User.create(name: "Alice", age: 30)

データベースにageカラムが存在しない場合、以下のエラーが発生する。

ActiveModel::UnknownAttributeError: unknown attribute 'age' for User.

マイグレーションの確認

データベースのスキーマを確認し、該当するカラムが存在するかをチェックする。

rails db:migrate:status

もしマイグレーションが適用されていない場合は、以下を実行する。

rails db:migrate

マイグレーションの修正

必要なカラムを追加するマイグレーションを作成する。

rails generate migration AddAgeToUsers age:integer
rails db:migrate

Strong Parametersの設定

コントローラーでStrong Parametersを正しく設定する。

class UsersController < ApplicationController
  def user_params
    params.require(:user).permit(:name, :age)
  end
end

許可されていないパラメータを渡すと、このエラーが発生することがある。

フォームのフィールド名を確認

ビューのフォームで正しいフィールド名を使用しているか確認する。

<%= form_with model: @user do |f| %>
  <%= f.label :name %>
  <%= f.text_field :name %>

  <%= f.label :age %>
  <%= f.text_field :age %> <!-- ageカラムがないとエラーが出る -->
<% end %>

カラムが存在しない場合、フィールドを削除するか、マイグレーションで追加する。

モデルのカラムを確認する

Railsコンソールでモデルのカラムを確認できる。

User.columns.map(&:name)

出力結果にageが含まれていない場合、データベースのカラムが存在しない可能性が高い。

データベースのリセット（最終手段）

データベースの変更をリセットして適用し直す場合は、以下を実行する。

rails db:reset

ただし、データが消えるため、本番環境では実行しないこと。

結論

このエラーは、モデルに存在しない属性を渡した場合に発生する。データベースのスキーマやStrong Parametersを確認し、適切に修正することで解決できる。