Sequelize 含类型列的多对多through表别名关联include异常问题

• required: true触发内连接过滤：这个参数会把关联查询的左连接（LEFT JOIN）改成内连接（INNER JOIN），只要任意一个关联没有匹配记录，整个主表的Foo行就会被过滤掉，最终只会返回至少存在一个关联的Foo记录，也就是你看到的只返回id=1条目、丢失空关联Foo的结果。
• 无required时数据错乱的本质：三个别名的多对多关联共用同一个FooBar中间表，Sequelize生成JOIN语句时默认没有给中间表分配独立的区分别名，三个关联的JOIN路径发生表名冲突，原本绑定了type='x'/'y'/'z'的scope条件被串接，最终导致Sequelize组装结果时只会识别第一个关联的JOIN返回的行，剩下两个关联的JOIN因为找不到正确的字段映射路径直接被丢弃为空数组，所有本该属于ys、zs的关联行因为没有对应字段映射就被塞进了xs的结果集里，连带把JOIN产生的null空行也一起带了进去，就出现了“xs多了null行、ys和zs全空”的错乱现象。
• 额外的潜在匹配错误：你定义FooBar模型时，fooId和barId字段设为STRING(32)类型，但Foo和Bar的主键是默认整数自增类型，两边外键类型不匹配会进一步放大关联条件的匹配错误。

你想要的“单次查询返回全量Foo、关联存在时正确返回对应Bar列表、无关联时返回空数组”的需求，可以通过以下两个调整同时实现：

1. 修正中间表的外键类型匹配 #

把FooBar里的外键字段调整为和主表主键一致的整数类型，避免类型不匹配导致的关联失败：

const FooBar = sequelize.define('fooBar', {
  fooId: { type: DataTypes.INTEGER, primaryKey: true },
  barId: { type: DataTypes.INTEGER, primaryKey: true },
  type: { type: DataTypes.ENUM('x', 'y', 'z'), primaryKey: true }
}, { tableName: 'foo_bar' })

2. 给每个关联的中间表指定独立别名 #

因为三个关联共用同一个中间表，必须显式在每个include里给对应JOIN的中间表分配不重复的独立别名，避免SQL生成时的表名冲突，同时保持required: false（即左连接，保留所有主表记录）：

const allFoos = await Foo.findAll({
  include: [
    {
      model: Bar,
      as: 'xs',
      required: false, // 左连接，无关联时不丢弃主表记录
      through: {
        attributes: [], // 不需要返回中间表的冗余字段
        as: 'foo_bar_for_xs' // 给当前关联的中间表指定独立别名
      }
    },
    {
      model: Bar,
      as: 'ys',
      required: false,
      through: {
        attributes: [],
        as: 'foo_bar_for_ys'
      }
    },
    {
      model: Bar,
      as: 'zs',
      required: false,
      through: {
        attributes: [],
        as: 'foo_bar_for_zs'
      }
    }
  ]
})

生成的SQL会对每个关联路径做独立的左连接：

• 中间表分别以foo_bar_for_xs、foo_bar_for_ys、foo_bar_for_zs的别名出现在JOIN子句中，不会出现表名冲突
• 每个JOIN都会自动带上定义关联时的scope条件：分别匹配type='x'、type='y'、type='z'的中间表记录
• 所有主表foo的记录都会被返回，不管有没有关联的Bar；有匹配的关联时，会自动组装对应的数据列表，无匹配时返回空数组，和你之前required: true时拿到的关联数据完全一致，同时不会丢失空关联的Foo记录。

内容的提问来源于stack exchange，提问作者Robin D.