sequelize-typescript中BelongsToMany关联：创建List时如何关联特定用户？

我正在用sequelize-typescript实现User与List的多对多（M:N）关联，依赖中间表UserList。按照文档尝试通过List.create方法同时创建List并关联用户，但没找到正确语法。

我的RouteList.ts代码如下：

import express from "express";
import { List } from "../models/List";
import { User } from "../models/User";


router.post("/", async (req, res) => {
 const { title, list, tags } = req.body;
 const lists = await List.findAll();

 if (!title || !list || !tags) {
   return res.status(400).json("Missing values");
 } else {
   req.body.id = lists.length + 1;

   await List.create(req.body, { include: [User] });
   return res.status(201).json("The list was succesfully created");
 }
});

List.ts与User.ts已配置@BelongsToMany关联，但调用List.create时无法将特定用户ID存入中间表UserList。想知道：如何让Sequelize自动将特定用户ID写入中间表？是否必须手动调用UserList.create？此前尝试添加用户ID的方式均出现语法错误或中间表无数据。

解决方案 #

不需要手动调用UserList.create，Sequelize支持在创建主模型时自动写入中间表，核心是要在create方法中正确传递关联的用户数据，而不是仅添加include选项。

1. 确认关联配置正确性 #

先确保List、User和中间表UserList的关联配置无误：

• List.ts：

@BelongsToMany(() => User, () => UserList)
users: User[];

• User.ts：

@BelongsToMany(() => List, () => UserList)
lists: List[];

• UserList.ts：

@Table
export class UserList extends Model<UserList> {
  @ForeignKey(() => User)
  @Column
  userId: number;

  @ForeignKey(() => List)
  @Column
  listId: number;
}

2. 修改List.create调用逻辑 #

当前代码仅通过{ include: [User] }声明要包含关联模型，但未传递具体要关联的用户ID。需在创建List的数据源中添加关联的用户字段，示例代码如下：

router.post("/", async (req, res) => {
  // 假设userId从请求体获取，或通过权限中间件从登录态提取
  const { title, list, tags, userId } = req.body;

  // 移除手动生成id的逻辑，数据库应配置自增主键，避免重复ID问题
  // const lists = await List.findAll();
  // req.body.id = lists.length + 1;

  if (!title || !list || !tags || !userId) {
    return res.status(400).json("Missing values");
  }

  await List.create(
    {
      title,
      list,
      tags,
      // 传入要关联的用户数组，元素可为用户实例、userId或含id的对象
      users: [{ id: userId }]
    },
    {
      // 指定包含User模型，through配置可控制是否返回中间表字段
      include: [{ model: User, through: { attributes: [] } }]
    }
  );

  return res.status(201).json("The list was successfully created");
});

3. 关键注意事项 #

• 必须在create的第一个参数（数据对象）中添加与模型关联属性名一致的字段（示例中为users），值为包含用户标识的数组（单个用户则传长度为1的数组）。
• 若需关联多个用户，只需扩展users数组即可：users: [{ id: 1 }, { id: 2 }]。
• 禁止手动生成主键ID，依赖数据库自增特性可避免并发场景下的ID冲突。

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