Rails NoMethodError问题：has_many与同名属性命名冲突

问题现象 #

在Rails 7.1.3.2、Ruby 3.3.0环境下，创建Parti实例时触发NoMethodError：

• 提交参数后日志报错：NoMethodError (undefined method 'each' for an instance of String)
• 控制台手动创建实例时报错：undefined method 'each' for an instance of Integer
  报错触发于回调执行阶段。

相关代码 #

模型代码 #

class Parti < ApplicationRecord
  belongs_to :shop
  belongs_to :aggregateparti, optional: true
  belongs_to :serving_table
  belongs_to :billing_option, class_name: 'Categoryminor'

  has_many   :covers, dependent: :destroy
  attr_accessor :serving_table_name
end

控制器Create动作及参数处理代码 #

class PartisController < ApplicationController
[...]
  def create
    serving_table = ServingTable.where(shop_id: @shop.id, name: params[:parti][:serving_table_name]).first
    params[:parti][:serving_table_id] = serving_table.id
    params[:parti][:shop_id] = @shop.id
binding.break 
    @parti = Parti.new(parti_params)
binding.break 

[...]
    def parti_params
      params.require(:parti).permit(:shop_id, :aggregateparti_id, :serving_table_id, :serving_table_name, :consumer_id, :server_id, :covers, :children_covers, :billing_option_id)
    end
end

问题根源 #

命名冲突：模型中声明的has_many :covers关联，与数据库中同名的covers字段（存储String/Integer类型值）发生冲突。Rails在处理实例属性时，混淆了关联集合（可调用each方法）和字段值（String/Integer类型，无each方法），导致调用each时触发报错。

解决方案 #

将数据库中的covers字段重命名为quantity_covers，同步更新以下内容：

1. 编写数据库迁移文件执行字段重命名操作
2. 将parti_params中的允许参数列表里的:covers替换为:quantity_covers
3. 代码中所有引用原covers字段的地方，改为quantity_covers

修改后既保留了has_many :covers的关联关系，又解决了命名冲突，参数处理恢复正常。

附加说明 #

若直接移除模型中的has_many :covers声明，报错会消失，但Rails 7中控制器动作的默认响应格式会从turbo_stream变为HTML，因此不推荐此操作。

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