Rails跨库关联另一数据库表添加where条件查询报错如何解决

Rails 处理跨库关联查询时，includes 遇到关联表条件会自动触发 eager_load 逻辑，强制用当前 User 模型的主库连接执行关联查询，不会读取 Account 模型配置的独立库连接，因此会在主库下查找 accounts 表导致报错。
你之前手动指定 account_base.accounts.state 不生效，是因为Hash形式的where条件会把字符串键中.前面的内容整体识别为表名，不会解析为库名+表名的组合。

方案1：子查询法（兼容性最好，推荐） #

分两次查询，先走Account的独立库查符合条件的账号ID，再查主库的用户，同时支持预加载避免N+1问题：

# 走account_base库查询所有激活状态的账号ID
activated_account_ids = Account.where(state: Account::STATE_ACTIVED).ids
# 走主库查询关联对应账号的用户，可直接预加载account数据
users = User.where(account_id: activated_account_ids).preload(:account)

该方案代码可读性最高，没有硬编码逻辑，适配所有Rails版本，数据量不大的场景下性能无损失。

方案2：手动写关联SQL（需要连表查询的场景） #

直接指定Account的完整库表名做关联查询，用Account.table_name自动获取带库名的完整表名，无需硬编码库名：

users = User.joins(
  "INNER JOIN #{Account.table_name} ON users.account_id = #{Account.table_name}.id"
).where("#{Account.table_name}.state = ?", Account::STATE_ACTIVED)

如果需要预加载account数据，可在后面追加.preload(:account)即可。

方案3：Rails 7+ 原生跨库查询 #

如果使用Rails 7及以上版本，框架已原生支持跨库关联条件查询，直接写即可：

users = User.where(account: Account.where(state: Account::STATE_ACTIVED)).preload(:account)

Rails 7会自动处理跨库逻辑，生成符合预期的查询语句。

• 跨库场景下不要用includes加关联表条件的写法，必然触发主库连表逻辑报错
• 不要硬编码account_base库名，通过Account.table_name获取完整表名，后续配置变更无需修改业务代码

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