Sequelize关联查询如何在JOIN ON子句添加额外AND条件

首先明确：Sequelize 基础关联配置只会自动生成外键匹配的 ON 条件，要追加a.type = 3这类额外的关联过滤条件，需要根据场景选择对应配置，避免把条件误写到 WHERE 子句中导致语义偏差。

场景1：仅在单次查询中追加该 ON 条件（推荐，灵活性最高） #

不需要修改已定义的基础关联规则，直接在查询的 include 配置块中补充自定义关联逻辑即可：

• 显式定义完整的 ON 匹配规则，覆盖默认的关联条件
• 配置 required: true，强制将连接类型设为 INNER JOIN，和原生SQL逻辑完全对齐
• 通过 Sequelize 的表字段占位符语法明确指定条件所属的表，避免字段名歧义

示例代码：

const { Op, Sequelize } = require('sequelize');

ModelA.findAll({
  include: [
    {
      model: ModelB,
      // 自定义完整的ON子句匹配规则
      on: {
        [Op.and]: [
          // 基础外键关联：a.bid = b.id
          { '$ModelA.bid$': Sequelize.col('ModelB.id') },
          // 追加的额外ON条件：a.type = 3
          { '$ModelA.type$': 3 }
        ]
      },
      // 强制使用INNER JOIN，替换默认的LEFT JOIN
      required: true
    }
  ]
})

上述代码生成的SQL和预期的原生逻辑完全一致：

SELECT * FROM a INNER JOIN b ON a.bid = b.id AND a.type = 3

场景2：所有关联查询都固定带该 ON 条件 #

如果只要用到 ModelA 关联 ModelB，就需要固定带上 a.type = 3 的限制，可以直接在定义关联配置时固化规则：

const { Op, Sequelize } = require('sequelize');

ModelA.belongsTo(ModelB, {
  foreignKey: 'bid',
  // 给关联规则固化默认的ON条件
  on: {
    [Op.and]: [
      { '$ModelA.bid$': Sequelize.col('ModelB.id') },
      { '$ModelA.type$': 3 }
    ]
  },
  // 固化默认INNER JOIN的连接类型
  required: true
})

配置完成后，后续所有直接调用基础关联的查询，都会自动带上对应的JOIN规则，不需要重复编写配置。

注意事项：不要将 a.type = 3 的条件写到 findAll 的顶级 where 参数中，该写法会把条件解析为 SQL 的 WHERE a.type = 3。虽然在INNER JOIN场景下查询结果可能和ON条件一致，但一旦后续调整连接类型为LEFT JOIN，会意外将LEFT JOIN过滤为实际的INNER JOIN，造成逻辑偏差。

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