使用Sequelize bulkCreate批量插入时自增主键设为NULL报错

问题根源 #

Sequelize未识别到id是自增主键，导致插入时主动将其设为NULL，而PostgreSQL的自增字段（serial/bigserial）不允许手动传入NULL，触发非空约束错误。

解决方案 #

1. 修正模型中id字段的配置 #

确保模型里给id字段加上autoIncrement: true，明确告诉Sequelize这是自增主键：

module.exports = (sequelize, DataTypes) => {
  const ProjectCategory = sequelize.define('ProjectCategory', {
    id: {
      type: DataTypes.INTEGER,
      primaryKey: true,
      autoIncrement: true, // 必须配置这一行
      allowNull: false
    },
    project_id: {
      type: DataTypes.INTEGER,
      allowNull: false
    },
    category_id: {
      type: DataTypes.INTEGER,
      allowNull: false
    }
  }, {
    tableName: 'project_categories'
  });
  return ProjectCategory;
};

2. 确认迁移文件的自增配置 #

迁移文件中同样要保证id字段开启autoIncrement，让PostgreSQL创建自增序列：

module.exports = {
  up: async (queryInterface, Sequelize) => {
    await queryInterface.createTable('project_categories', {
      id: {
        allowNull: false,
        autoIncrement: true,
        primaryKey: true,
        type: Sequelize.INTEGER
      },
      project_id: {
        type: Sequelize.INTEGER,
        allowNull: false
      },
      category_id: {
        type: Sequelize.INTEGER,
        allowNull: false
      }
    });
  },
  down: async (queryInterface) => {
    await queryInterface.dropTable('project_categories');
  }
};

注意：如果之前已经执行过迁移，需要重新生成表（或手动给id字段添加自增序列）。

3. 插入数据时不要传入id字段 #

批量插入的数据集里，只保留project_id和category_id，不要包含id（不管是null还是其他值）：

// 错误示例（会触发问题）
// const bulkData = [{ id: null, project_id: '31', category_id: 29 }, ...];

// 正确示例
const bulkData = [{ project_id: '31', category_id: 29 }, { project_id: '32', category_id: 30 }];
await ProjectCategory.bulkCreate(bulkData);

4. 检查依赖版本兼容性 #

确保sequelize和pg（PostgreSQL适配器）版本兼容，比如：

• sequelize@6.x 搭配 pg@8.x
• 避免使用过于老旧的版本，可能存在自增字段的处理bug

验证 #

修正后执行插入，生成的SQL应该不会包含id字段，比如：

INSERT INTO "project_categories" ("project_id","category_id") VALUES ('31',29) RETURNING "id","project_id","category_id"

此时PostgreSQL会自动生成id的值，不会触发非空约束错误。

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