Sequelize多对多关联下单次调用create传入内嵌对象时关联表未生成问题

核心错误原因 #

• Sequelize 中create方法配合include参数时，默认行为是创建新的关联记录同时绑定关联，不会主动识别你传入的是已存在的关联数据。你代码中的admin角色已提前入库，默认写法下Sequelize会尝试插入新的role: admin记录，触发主键唯一性约束冲突后，关联操作直接终止，自然不会生成中间表记录。
• 你定义UserRole中间表时传入的sequelize实例为db.db，如果和User、Role初始化时用的sequelize实例不是同一个，会导致关联关系不生效，这也是高频出错点。

修复方案 #

方案1：单次create调用实现（Sequelize v6+ 支持） #

在关联数据中添加__existing: true标记，明确告知Sequelize该记录已存在，仅需要绑定关联即可：

const userData =  { 
  nameUser: 'test-name-2', 
  roles: [
    { role: 'admin', __existing: true } // 标记为已存在的记录
  ] 
};
const options = { include: Role };
const user = await User.create(userData, options);

方案2：事务内拆分操作（兼容性更强） #

如果使用的Sequelize版本不支持__existing标记，可以通过事务实现原子操作，且不需要额外查询Role实例：

const transaction = await sequelize.transaction();
try {
  // 1. 创建用户
  const user = await User.create({ nameUser: 'test-name-2' }, { transaction });
  // 2. 直接传Role主键数组绑定关联，不需要提前查询实例
  await user.addRoles(['admin'], { transaction });
  await transaction.commit();
} catch (err) {
  await transaction.rollback();
  throw err;
}

认知盲区补充 #

• 多对多关联的add/set/remove系列方法，支持直接传入主键值/主键数组，不需要先查询得到完整的模型实例，你原来的写法可以直接简化为user.addRoles(['admin', 'basic'])，省略查询Role的步骤。
• include参数在create/update场景下默认是创建新关联记录，如果需要绑定已有的记录，必须加__existing标记，否则会触发新建逻辑。
• 所有关联的模型必须绑定同一个sequelize实例，否则关联规则不会生效。

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