如何为TypeORM的PrimaryGeneratedColumn设置初始AUTO_INCREMENT值？

TypeORM的PrimaryGeneratedColumn本身不提供直接配置AUTO_INCREMENT初始值的参数，但可以通过以下两种方式实现需求：

1. 利用数据库特定的列选项 #

针对不同数据库，可通过columnDefinition选项直接写入数据库原生语句来指定自增起始值：

MySQL/MariaDB示例 #

import { Entity, PrimaryGeneratedColumn } from "typeorm";

@Entity()
export class User {
  @PrimaryGeneratedColumn({
    type: "int",
    columnDefinition: "INT AUTO_INCREMENT PRIMARY KEY AUTO_INCREMENT=1000"
  })
  id: number;

  // 其他列定义...
}

不同数据库的语法差异：

• PostgreSQL：使用SERIAL START 1000或GENERATED AS IDENTITY (START WITH 1000)
• SQL Server：IDENTITY(1000,1)

2. 通过迁移文件手动配置 #

如果使用TypeORM的迁移功能，在创建表的迁移文件中直接设置自增起始值，这种方式更灵活且适合生产环境：

MySQL迁移文件示例 #

import { MigrationInterface, QueryRunner } from "typeorm";

export class CreateUserTable1620000000000 implements MigrationInterface {
  public async up(queryRunner: QueryRunner): Promise<void> {
    await queryRunner.query(`
      CREATE TABLE user (
        id INT AUTO_INCREMENT PRIMARY KEY,
        -- 其他列定义
      ) AUTO_INCREMENT=1000;
    `);
  }

  public async down(queryRunner: QueryRunner): Promise<void> {
    await queryRunner.query(`DROP TABLE user`);
  }
}

PostgreSQL迁移文件示例 #

public async up(queryRunner: QueryRunner): Promise<void> {
  await queryRunner.query(`
    CREATE TABLE user (
      id SERIAL PRIMARY KEY,
      -- 其他列定义
    );
    ALTER SEQUENCE user_id_seq START WITH 1000;
  `);
}

注意事项 #

• 使用columnDefinition会覆盖TypeORM自动生成的列定义，需确保语法符合目标数据库规范
• 迁移文件方式能精确控制数据库结构变更，更适合团队协作和生产环境
• 部分数据库（如SQLite）的自增起始值配置逻辑不同，需参考对应数据库官方文档

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