Sequelize插入数据时如何忽略关联模型的重复记录

API 探路者

2026-9-3

问题背景

现有两张存在关联关系的数据表：

cars（汽车表）：通过外键字段关联manufacturers表，表内model字段设置了唯一键约束
manufacturers（厂商表）：name字段设置了唯一键约束

在Sequelize中通常用如下写法，实现单次调用创建car实例时自动级联创建关联的manufacturer实例：

Car.create({
    model: "i4",
    Manufacturer: {
        name: "BMW",
    },
}, {
    include: [Manufacturer],
});

上述代码在无唯一键冲突时可正常运行，添加ignoreDuplicates: true配置仅能解决cars表的唯一键冲突，无法处理manufacturers表的重复值报错。需要实现的逻辑为：

若关联的manufacturer已存在，则仅插入car行数据，自动关联已有厂商
若car和manufacturer均已存在，则不执行任何写入操作

实现方案

Sequelize 原生带include的create级联创建逻辑，默认会强制尝试新建所有被关联的实例，没有内置「关联记录存在则直接复用」的配置项，且ignoreDuplicates: true配置仅对主调用模型生效，不会传递给include进来的关联模型，这也是它无法处理关联表唯一键冲突的根本原因。

要实现需求，直接用事务搭配findOrCreate分步写即可，完全匹配要求的逻辑：

const result = await sequelize.transaction(async (t) => {
  // 先查询厂商：存在直接返回现有实例，不存在则新建
  const [manufacturer] = await Manufacturer.findOrCreate({
    where: { name: "BMW" },
    transaction: t
  });

  // 再查询车型：存在直接返回，不存在则绑定已拿到的厂商ID新建
  const [car] = await Car.findOrCreate({
    where: { model: "i4" },
    defaults: {
      ManufacturerId: manufacturer.id // 替换为你实际在cars表定义的外键字段名
    },
    transaction: t
  });

  return { car, manufacturer };
});

如果追求更高性能，不想做前置存在性查询，可以换成数据库层面的upsert实现，逻辑等价：

await sequelize.transaction(async (t) => {
  // 厂商存在则跳过写入，不存在则新建，最终都会返回对应厂商实例
  const [manufacturer] = await Manufacturer.upsert(
    { name: "BMW" },
    { transaction: t }
  );

  // 车型存在则跳过写入，不存在则绑定厂商ID新建
  await Car.upsert(
    {
      model: "i4",
      ManufacturerId: manufacturer.id
    },
    { transaction: t }
  );
});

两种写法的差异：

findOrCreate：严格遵循「已存在则不执行写入」的逻辑，先查后写，记录存在时不会触发任何写操作
upsert：基于数据库的ON DUPLICATE KEY UPDATE语法，记录存在时不会修改数据（传入字段和存量一致的前提下），但会执行一次upsert调用，高并发场景下性能更好

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