Sequelize bulkCreate的updateOnDuplicate失效：仅插入新行不更新

API 探路者

2026-8-21

问题：Sequelize bulkCreate 重复插入而非更新数据

我用 Sequelize 6.12.5 搭建 Express + MariaDB 后端，前端更新数据时，数据库总是插入新的重复行，没有更新原有行。

问题代码

//Create Bulk Entries
const reportEntries =  await ReportEntry.bulkCreate(entries, {
  ignoreDuplicates: true,
  updateOnDuplicate: ['input_section_id', 'input_item_id', 'quantity', 'input_const', 'total']
})
return res.status(201).json({ entries: reportEntries });

ReportEntry 模型定义

ReportEntry.init({
    facility_id: DataTypes.INTEGER,
    business_id: DataTypes.INTEGER,
    input_section_id: DataTypes.INTEGER,
    input_item_id: DataTypes.INTEGER,
    input_const: DataTypes.DECIMAL(10,3),
    quantity: DataTypes.DECIMAL(10,3),
    total: DataTypes.DECIMAL(10,3),
    is_offset: DataTypes.BOOLEAN,
    year: DataTypes.INTEGER,
    quarter: DataTypes.STRING
  }, {
    sequelize,
    modelName: 'ReportEntry',
    tableName: 'ch_report_entries',
    underscored: true,
    createdAt: 'created_at',
    updatedAt: 'updated_at'
  });

排查解决方案

必须设置唯一约束：bulkCreate 的 updateOnDuplicate 功能依赖数据库的唯一键（或主键）识别重复行。当前模型和数据库表都缺少唯一约束，需要确定业务层面的唯一标识组合（比如 facility_id + business_id + year + quarter + input_item_id），可以在模型中通过 unique 属性定义，或直接在数据库表添加唯一索引。
修正 updateOnDuplicate 参数：确保参数包含需要更新的字段，注意触发更新的前提是唯一约束被命中；无需把唯一键字段加入该参数，因为它们是用来判断重复的标识，而非更新对象。
校验传入数据：检查前端传入的 entries 数组中，每条数据的唯一标识字段值是否与数据库现有行匹配。若标识值不重合，Sequelize会判定为新数据执行插入。
验证数据库表结构：直接查看数据库表 ch_report_entries，确认是否已正确添加唯一约束。若表无唯一约束，updateOnDuplicate 完全不会生效，只会持续插入新行。