Rails使用form_for报错：undefined method `to_key' for ActiveRecord::Relation

错误根源 #

你遇到的未定义方法to_key' 用于 #<ActiveRecord::Relation []>错误，核心原因很明确：**form_for必须接收单个ActiveRecord对象实例**（比如新建的空对象或者从数据库查询到的单个记录），但你的@customer是一个ActiveRecord::Relation（也就是查询集合，这里是空集合），这类集合对象没有to_key`方法——而这个方法是Rails用来生成表单提交路径的关键。

快速修复步骤 #

1. 修正控制器中的@customer赋值

打开对应的控制器（比如customers_controller.rb），检查new或edit动作里的@customer定义：

• 如果是新建客户表单（对应new动作）：

  def new
    @customer = Customer.new # ✅ 正确：创建单个空对象
  end
  

• 如果是编辑客户表单（对应edit动作）：

  def edit
    @customer = Customer.find(params[:id]) # ✅ 正确：查询单个现有对象
  end
  

❌ 错误的写法示例（会返回集合，触发报错）：

@customer = Customer.all # 返回所有客户的集合
@customer = Customer.where(email: params[:email]) # 返回匹配条件的客户集合

2. 优化视图中的表单代码

你的原表单里有重复输入框，且属性名不符合Rails约定（Rails推荐蛇形命名，比如name_and_family_name而非NameAndFamilyName），可以修正成这样：

<%= form_for @customer do |f| %>
  <ul>
    <li><%= f.text_field :name_and_family_name, class: 'form-input', placeholder: 'نام و نام خانوادگی' %></li>
    <li><%= f.text_field :mobile, class: 'form-input', placeholder: 'تلفن همراه' %></li>
    <li><%= f.email_field :email, class: 'form-input', placeholder: 'آدرس ایمیل' %></li>
    <li><%= f.text_field :subject, class: 'form-input', placeholder: 'موضوع پیام' %></li>
    <li><%= f.text_area :message, placeholder: 'متن پیام' %></li>
    <li><%= f.submit 'ارسال پیام' %></li>
  </ul>
<% end %>

额外注意事项 #

• 模型属性名尽量用蛇形小写命名（name_and_family_name），这是Rails的核心约定，能避免很多奇怪的兼容性问题。
• 避免用纯数字作为CSS类名（比如class:'1'），换成有语义的类名（比如form-input），更利于后期维护。
• 如果确实需要批量处理多个对象的表单，要使用fields_for配合form_for，但你的场景明显是单个客户的表单，所以不需要这个逻辑。

内容的提问来源于stack exchange，提问作者Farid Hosseini