Ruby on Rails嵌套模型关联报错：找不到admin_products表排查

问题根源 #

你遇到的main.products不存在的错误，本质是Rails的关联默认规则和你的命名空间模型、自定义主键不匹配：

1. 仅指定class_name: "Admin::Product"时，Rails仍会默认按照关联名product去寻找products表，而非Admin模块前缀的admin_products
2. 你的Admin::Product主键是自定义的ect，而非默认的id，但CartProduct的关联和迁移都没适配这个自定义主键

分步解决方案 #

1. 修正模型关联配置 #

修改models/cart_product.rb，明确指定外键、关联模型的主键：

class CartProduct < ApplicationRecord
  belongs_to :product, 
             class_name: "Admin::Product", 
             foreign_key: "product_ect", 
             primary_key: "ect"
  belongs_to :cart
end

同步修正models/admin/product.rb的反向关联，确保双向匹配：

class Admin::Product < ApplicationRecord
  has_many :cart_products, 
           foreign_key: "product_ect", 
           primary_key: "ect"
  has_many :carts, through: :cart_products
end

2. 修正数据库迁移（分两种情况） #

情况1：还未运行CartProducts的迁移

直接修改db/migrate/xxx_create_cart_products.rb：

class CreateCartProducts < ActiveRecord::Migration[7.0]
  def change
    create_table :cart_products do |t|
      # 替换原来的t.belongs_to :product
      t.bigint "product_ect", null: false
      t.belongs_to :cart, null: false, foreign_key: true
      t.integer :quantity

      t.timestamps
    end
    # 添加指向admin_products表的外键约束
    add_foreign_key :cart_products, :admin_products, column: :product_ect, primary_key: :ect
  end
end

然后运行迁移：rails db:migrate

情况2：已经运行过CartProducts的迁移

生成新的迁移文件：

rails generate migration FixCartProductForeignKey

编辑新迁移文件，修正字段和外键：

class FixCartProductForeignKey < ActiveRecord::Migration[7.0]
  def change
    # 移除原有错误的外键和字段
    remove_foreign_key :cart_products, :products
    remove_column :cart_products, :product_id

    # 添加正确的字段和外键约束
    add_column :cart_products, :product_ect, :bigint, null: false
    add_foreign_key :cart_products, :admin_products, column: :product_ect, primary_key: :ect
  end
end

运行迁移：rails db:migrate

3. 控制器代码适配（可选） #

虽然关联配置正确后，@cart.cart_products.create(product: @product, quantity:)可以自动映射外键，但也可以显式指定外键字段让代码更清晰：

@cart.cart_products.create(product_ect: @product.ect, quantity:)

为什么会出现main.products？ #

SQLite里的main是默认数据库的别名，Rails根据关联名product默认生成的SQL会去查询main.products表，但你的Product模型在Admin命名空间下，表名是admin_products，同时迁移里的外键约束也错误指向了products表，所以触发了找不到表的错误。

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