Rails中STI子模型搭配连接表实现多对多关联配置方案

完全可以用单张连接表实现你要的所有查询效果，不需要为每个Keyword子类单独建关联表，配置完成后既支持user.keyword1s的直接关联调用，也支持user.keywords.keyword1s的链式筛选调用。

连接表只需要保留最基础的双外键结构即可，不需要额外加type字段，类型信息统一由keywords表的STI自带type列维护，避免多存一份类型数据导致不一致。
连接表迁移代码如下：

class CreateUserKeywords < ActiveRecord::Migration[7.0]
  def change
    create_table :user_keywords do |t|
      t.references :user, null: false, foreign_key: true
      t.references :keyword, null: false, foreign_key: true
      t.timestamps
    end
    # 加联合唯一索引，避免同一用户重复关联同一个关键词
    add_index :user_keywords, [:user_id, :keyword_id], unique: true
  end
end

连接表模型代码非常简单，不需要额外配置：

class UserKeyword < ApplicationRecord
  belongs_to :user
  belongs_to :keyword
end

在User模型中先定义基础的全量关键词关联，再针对每个STI子类单独定义带类型过滤的关联即可。
如果子类数量少，可以直接手写定义：

class User < ApplicationRecord
  has_many :user_keywords, dependent: :destroy
  has_many :keywords, through: :user_keywords

  # 针对每个子类定义独立关联，自动带type过滤条件
  has_many :keyword1s, -> { where(type: "Keyword1") }, through: :user_keywords, source: :keyword
  has_many :keyword2s, -> { where(type: "Keyword2") }, through: :user_keywords, source: :keyword
  has_many :keyword3s, -> { where(type: "Keyword3") }, through: :user_keywords, source: :keyword
end

如果后续子类会持续增加，可以用动态定义的方式减少重复代码：

class User < ApplicationRecord
  has_many :user_keywords, dependent: :destroy
  has_many :keywords, through: :user_keywords

  # 自动为所有Keyword子类生成对应关联
  def self.generate_keyword_associations
    Keyword.descendants.each do |kw_class|
      assoc_name = kw_class.model_name.plural.to_sym
      has_many assoc_name, -> { where(type: kw_class.name) }, through: :user_keywords, source: :keyword
    end
  end

  # 开发环境需要配合模型预加载使用，避免懒加载导致子类未加载
  generate_keyword_associations
end

以上方式定义的是ActiveRecord原生关联，支持所有关联自带方法：比如user.keyword1s.create!(name: "测试关键词")会自动把记录类型设为Keyword1，不需要手动传type参数；预加载、级联删除等特性都能正常生效，没有额外性能问题。

在Keyword父类上添加对应作用域，即可支持user.keywords.keyword1s的链式写法。
少量子类可以直接手写：

class Keyword < ApplicationRecord
  scope :keyword1s, -> { where(type: "Keyword1") }
  scope :keyword2s, -> { where(type: "Keyword2") }
  scope :keyword3s, -> { where(type: "Keyword3") }
end

子类多的话同样可以动态生成：

class Keyword < ApplicationRecord
  def self.generate_type_scopes
    descendants.each do |kw_class|
      scope kw_class.model_name.plural.to_sym, -> { where(type: kw_class.name) }
    end
  end

  generate_type_scopes
end

这种链式调用的查询结果、执行效率和直接调用专属关联完全一致，适合需要动态拼接查询条件的场景。

这套方案是该场景下的标准最优实践：

• 表结构最简：仅用3张核心表存储所有数据，没有冗余字段和冗余表，数据一致性维护成本极低
• 扩展性强：后续新增Keyword子类时，不需要修改数据库结构，只需要新增子类模型即可，用动态生成代码的话甚至不需要加额外配置
• 符合Rails设计惯例：没有绕过ActiveRecord的原生机制，所有关联特性、查询优化都能正常生效，不会出现兼容问题
• 无额外性能损耗：所有查询都是Rails自动生成的JOIN+WHERE条件，和手写user.keywords.where(type: "Keyword1")的执行计划完全一致，没有额外开销

注意：开发环境如果使用动态生成关联/作用域的写法，需要在配置中开启模型预加载，或者把动态定义逻辑放到Rails.application.config.to_prepare块中，避免Rails懒加载模型导致子类未加载、关联缺失的问题。

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