如何用Sequelize实现双字段LEFT JOIN？SQL转换遇问题求助

问题场景 #

需要实现从Issue表左连接File1表的查询，关联条件同时匹配project_id和file_path两个字段，并且过滤Issue表中project_id=1和version_id=1的数据。此前使用@BelongsTo关联生成的SQL仅包含project_id的关联条件，缺少file_path的匹配，不符合预期。

原目标SQL #

SELECT
    * 
FROM
    Issue
    LEFT OUTER JOIN File1 ON File1.project_id = Issue.project_id 
    AND File1.file_path = Issue.file_path 
WHERE
    Issue.project_id = 1 
    AND version_id =1

尝试的错误代码及问题 #

使用@BelongsTo关联仅指定单个外键，导致生成的SQL缺失file_path关联条件：

class Issue extends Model<attributes, creationAttributes> {
    ...

  @BelongsTo(() => File1, {
    foreignKey: "project_id",
    targetKey: "projectId",
    constraints: false,
  })
  file!: File1;
}

Issue.findAll({
    where:{
        projectId:1,
        versionId:1
    },
    include:[File1]
})

生成的不符合预期的SQL：

SELECT
    * 
FROM
    Issue
    LEFT OUTER JOIN File1 ON File1.project_id = Issue.project_id 
WHERE
    Issue.project_id = 1 
    AND version_id =1

正确实现方案 #

方案1：查询时直接自定义关联条件（推荐，灵活） #

不需要依赖模型预定义关联，直接在findAll的include选项中指定完整ON条件，同时设置required: false确保是LEFT JOIN：

Issue.findAll({
  where: {
    projectId: 1,
    versionId: 1
  },
  include: [{
    model: File1,
    required: false, // 强制使用LEFT JOIN（默认是INNER JOIN）
    on: {
      // 使用Sequelize.col确保字段引用正确
      project_id: Sequelize.col('Issue.project_id'),
      file_path: Sequelize.col('Issue.file_path')
    }
  }]
})

方案2：修改模型关联定义（适合复用关联逻辑） #

如果需要在多个查询中复用该双字段关联，可以修改@BelongsTo选项，通过on参数指定完整关联条件：

class Issue extends Model<attributes, creationAttributes> {
    ...

  @BelongsTo(() => File1, {
    constraints: false, // 避免自动创建数据库约束（可选，根据需求）
    on: {
      project_id: Sequelize.col('Issue.project_id'),
      file_path: Sequelize.col('Issue.file_path')
    }
  })
  file!: File1;
}

// 查询时直接include关联即可
Issue.findAll({
  where: {
    projectId: 1,
    versionId: 1
  },
  include: [File1]
})

关键说明 #

• required: false是实现LEFT JOIN的核心，默认include会生成INNER JOIN，必须显式设置为false。
• 使用Sequelize.col()可以避免字段名被Sequelize自动转换（比如驼峰转下划线），确保关联条件引用正确的表字段。

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