Rails分库场景下has_and_belongs_to_many关联时joins表错误问题

这个问题的根因是Rails默认将跨模型关联的join查询绑定到关联目标（User模型）的数据库连接，而你的HABTM中间表todos_users实际存储在Todo模型所属的分库中，导致查询时读错了中间表的库。可通过以下方案修复：

方案1：替换隐式HABTM为显式has_many :through关联（推荐，兼容Rails 6.1+） #

这种方式可以明确控制中间表的连接归属，彻底避免连接库选错的问题：

1. 新增中间表模型，继承自ApplicationRecord使用分库连接：

class TodosUser < ApplicationRecord
  belongs_to :todo
  belongs_to :user
end

2. 修改Todo模型的关联定义，增加disable_joins: true避免跨库join：

class Todo < ApplicationRecord
  has_many :todos_users
  has_many :users, through: :todos_users, disable_joins: true
end

修改后执行查询时会生成两次独立查询：

• 先在当前分库查询todos和对应的todos_users记录，获取关联用户ID
• 再到大公司主库查询users表匹配用户ID，不会出现跨库join、读错中间表的问题

方案2：Rails 7 直接配置HABTM关联属性 #

如果不想新增中间模型，升级到Rails 7后可以直接在HABTM关联上指定查询规则：

class Todo < ApplicationRecord
  has_and_belongs_to_many :users, disable_joins: true, associated_against: :self
end

associated_against: :self指定中间表使用当前Todo模型的数据库连接，disable_joins: true避免跨库join操作。

临时方案：手动分步骤查询 #

如果暂时不想修改模型定义，可以手动拆分查询逻辑：

DatabaseProxy.on_shard(shard: :small_company) do
  todo = Todo.first
  # 手动在分库查询中间表获取用户ID
  user_ids = TodosUser.where(todo_id: todo.id).pluck(:user_id)
  # 到主库查询用户
  users = User.where(id: user_ids)
end

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