Sequelize ORM创建新用户时自增ID功能异常求助

问题根源分析 #

1. 模型主键冲突：User模型中同时将id和uuid标记为primaryKey: true，Sequelize仅会将最后定义的主键作为实际主键处理，导致id的自增逻辑失效。
2. 迁移文件缺失主键配置：创建用户表的迁移文件中，id字段未设置primaryKey: true，数据库层面未正确识别其为主键自增字段。
3. 种子文件手动指定ID：种子文件中手动给每条数据指定id值，但插入后未更新数据库的自增序列计数器，导致后续自动生成的ID从1开始，出现重复。

分步解决方案 #

1. 修正User模型的主键配置 #

打开models/user.js，将uuid字段的primaryKey改为false，确保仅id作为主键：

User.init({
    id: {
        type: DataTypes.INTEGER,
        primaryKey: true,
        autoIncrement: true,
        allowNull: false
    },
    uuid: {
        type: DataTypes.UUID,
        defaultValue: DataTypes.UUIDV4,
        allowNull: false,
        unique: true,
        primaryKey: false, // 修改此处
    },
    // ... 其他字段配置
}, {
    // ... 模型其他配置
});

2. 修正迁移文件的主键配置 #

打开migrations/20230223064615-create-user.js，给id字段添加primaryKey: true：

await queryInterface.createTable('Users', {
    id: {
        allowNull: false,
        autoIncrement: true,
        type: Sequelize.INTEGER,
        primaryKey: true, // 添加此行
        onDelete: 'CASCADE'
    },
    // ... 其他字段配置
});

3. 调整种子文件的ID处理 #

两种可选方案：

方案A：移除手动指定的ID

种子文件中不再手动设置id，让数据库自动生成：

const users = [{
    // 移除 id: 1,
    uuid: uuidv4(),
    username: 'johndoe',
    email: 'johndoe@example.com',
    password: 'password123'
}, {
    // 移除 id: 2,
    uuid: uuidv4(),
    username: 'janedoe',
    email: 'janedoe@example.com',
    password: 'password456'
},
// ... 其他用户数据
];

方案B：插入后更新自增序列

若需保留手动指定的ID，在种子文件的up函数末尾添加代码，更新自增序列到当前最大ID值：

await queryInterface.bulkInsert('Users', users, {});
// 更新自增序列
await queryInterface.sequelize.query(
    "SELECT setval('\"Users_id_seq\"', (SELECT MAX(id) FROM \"Users\"));"
);

4. 重置现有数据库的自增序列（已存在重复数据时） #

进入PSQL终端，执行以下SQL重置序列：

SELECT setval('"Users_id_seq"', (SELECT MAX(id) FROM "Users"));

验证修复 #

重新运行种子文件和测试：

npx sequelize-cli db:seed:all
npm test

此时新创建的用户ID会自动从4开始，不会出现重复。

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