使用自定义列名在Rails模型间创建关联的问题排查

Rails的has_many关联默认会用「关联模型名+_id」作为外键字段（这里就是country_id），但你的数据库设计中用country_code作为外键，再加上模型处于CodeTable命名空间下，has_many没有正确识别关联模型的位置和自定义外键，导致尝试写入不存在的country_id字段，从而触发错误。

1. 修正Country模型的关联配置 #

在has_many中明确指定关联模型的完整类名和自定义外键：

class CodeTable::Country < ApplicationRecord
  self.primary_key = "country_code"

  has_many :provinces, 
           class_name: 'CodeTable::Province', # 指明关联的是命名空间内的Province模型
           foreign_key: 'country_code'        # 指定用country_code作为外键，而非默认的country_id
end

（可选添加primary_key: 'country_code'，虽然已通过self.primary_key设置主键，但显式指定会让逻辑更清晰）

2. 确认Province模型的关联定义（你的现有代码已正确，可再核对） #

class CodeTable::Province < ApplicationRecord
  self.primary_key = "province_code"

  belongs_to :country, 
             class_name: 'CodeTable::Country',
             foreign_key: "country_code",
             primary_key: "country_code"
end

这里指定class_name是避免Rails找不到命名空间内的Country模型，primary_key则对应Country的自定义主键。

3. 保持迁移文件的正确状态 #

你最后修改的Province迁移已经符合要求，之前添加的t.references :countries会生成多余的country_id字段，删掉后手动添加country_code字段和外键约束的做法是对的：

class CreateCodeTableProvinces < ActiveRecord::Migration[7.0]
  def change
    create_table :provinces, primary_key: "province_code", id: { type: :string, limit: 20 }, force: :cascade do |t|
      t.string :country_code, limit: 2, null: false
      t.string :screen_label, limit: 80, null: false
      t.boolean :is_active, default: true, null: false
      t.integer :display_order, limit: 2, default: 10, null: false
    end

    add_foreign_key :provinces, :countries, column: "country_code", primary_key: "country_code", name: "country_province_fk"
  end
end

4. 测试关联创建 #

现在可以正常通过关联创建Province，甚至不需要手动传入country_code，关联会自动填充该字段：

country.provinces.create!(
  province_code: item["provinceCode"], 
  screen_label: item["screenLabel"], 
  is_active: item["isActive"], 
  display_order: item["displayOrder"]
)

• 使用自定义主键/外键时，必须在has_many和belongs_to中显式指定对应字段，不要依赖Rails的默认推断
• 模型处于命名空间下时，一定要通过class_name指定完整的模型路径
• 避免使用t.references生成默认的_id外键，手动添加字段再用add_foreign_key建立数据库级约束，更适配自定义数据库设计

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