Sequelize跨数据库模型关联：Include查询时模型找错库求助

我之前也踩过这个坑！当两个模型分属不同数据库时，直接用include确实会让Sequelize“找错地方”——它会默认用当前模型的数据库连接去查询关联表，所以才会出现从Brand所在库找Product的情况。下面是具体的解决步骤：

1. 确保模型分属不同的Sequelize实例 #

首先要明确，每个数据库对应一个独立的Sequelize连接实例，模型必须绑定到对应的实例上。比如：

// 连接产品数据库
const productDb = new Sequelize('products_db', 'your_user', 'your_pass', {
  host: 'localhost',
  dialect: 'mysql' // 换成你用的数据库类型，比如postgres
});

// 连接品牌数据库
const brandDb = new Sequelize('brands_db', 'your_user', 'your_pass', {
  host: 'localhost',
  dialect: 'mysql'
});

// 定义Product模型（绑定到产品库实例）
const Product = productDb.define('Product', {
  name: DataTypes.STRING,
  brandId: DataTypes.INTEGER
}, { tableName: 'products' });

// 定义Brand模型（绑定到品牌库实例）
const Brand = brandDb.define('Brand', {
  name: DataTypes.STRING
}, { tableName: 'brands' });

2. 查询时手动指定跨库关联的表信息 #

因为两个模型属于不同的连接实例，无法提前在模型上定义belongsTo/hasOne这类关联（会报错），所以需要在findAll的include选项里手动配置关联规则，关键是要告诉Sequelize关联表的完整数据库+表名：

const getProductsWithBrands = async () => {
  const result = await Product.findAll({
    include: [
      {
        model: Brand,
        // 明确关联条件
        where: { id: Product.brandId },
        // 核心：指定完整的表引用（数据库名.表名）
        tableName: 'brands_db.brands',
        // 可选：设置为false是左连接，true是内连接
        required: false,
        // 指定要返回的品牌字段，避免查冗余数据
        attributes: ['id', 'name']
      }
    ]
  });
  return result;
};

这样Sequelize生成的SQL会是类似这样的（以MySQL为例）：

SELECT `Product`.*, `Brand`.`id` AS `Brand.id`, `Brand`.`name` AS `Brand.name` 
FROM `products_db`.`products` AS `Product` 
LEFT OUTER JOIN `brands_db`.`brands` AS `Brand` 
ON `Brand`.`id` = `Product`.`brandId`;

3. 必要的前提条件 #

• 两个数据库必须在同一个数据库服务器上，并且你的数据库账号拥有访问这两个库的权限（跨服务器的话没法用JOIN，只能分开查询再手动组装数据）。
• 如果是PostgreSQL这类区分schema的数据库，把tableName换成schema: 'brands_schema'（在模型定义或include里设置）即可，不用写数据库名。

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