如何通过TypeORM为已有实体表添加带唯一约束的自增字段

我完全懂你的困扰——你想要通过TypeORM生成和目标SQL一致的操作，给已有实体表加一个带唯一约束的自增字段，但当前的注解组合触发了MySQL的报错，核心问题就是TypeORM生成的SQL只加了自增字段，没同步带上唯一约束，违反了MySQL「自增字段必须是主键或唯一键」的规则。

先明确你的目标SQL是这样的：

ALTER TABLE `some_entity`
ADD `generatedNumber` INT NOT NULL AUTO_INCREMENT,
ADD UNIQUE (`generatedNumber`);

而你当前的代码因为生成的SQL缺失唯一约束，导致了ER_WRONG_AUTO_KEY错误。下面给你解决思路和具体方案：

正确的注解组合方式 #

你需要把自增配置和唯一约束整合到@Column装饰器中，同时避免重复注解的冲突。把你当前的generatedNumber字段替换成下面的写法：

@Column({
  type: 'int',
  nullable: false,
  unique: true, // 声明唯一约束
  generated: 'increment', // 配置自增逻辑
  unsigned: true // 可选，推荐用无符号整数避免负数问题
})
generatedNumber: number;

注意要移除单独的@Generated('increment')装饰器——因为@Column里的generated选项已经能实现自增功能，重复使用反而可能导致逻辑冲突。另外类上的@Unique(['generatedNumber'])可以保留，但@Column里的unique: true已经足够生成唯一约束，二者选其一即可。

为什么之前的方法不生效？ #

你之前分开使用@Column()+@Generated('increment')+@Unique的组合时，TypeORM的synchronize机制会先尝试添加无约束的自增字段，这直接触发了MySQL的报错，导致后续添加唯一约束的步骤根本没机会执行。而把所有配置整合到@Column后，TypeORM会生成包含唯一约束的字段添加语句，和你期望的SQL结构完全一致。

如果还是有问题？ #

如果上述方法在synchronize模式下依然异常，可能是TypeORM版本的兼容性问题，建议升级到最新稳定版。另外，虽然你提到想用synchronize而非迁移，但在CI环境中，迁移其实是更可靠的方案——你可以预先生成迁移脚本，手动调整成你需要的SQL逻辑，在CI流程中执行迁移：

import { MigrationInterface, QueryRunner } from "typeorm";

export class AddGeneratedNumberToSomeEntity1620000000000 implements MigrationInterface {
    public async up(queryRunner: QueryRunner): Promise<void> {
        await queryRunner.query(`
            ALTER TABLE \`some_entity\`
            ADD \`generatedNumber\` INT NOT NULL AUTO_INCREMENT,
            ADD UNIQUE (\`generatedNumber\`);
        `);
    }

    public async down(queryRunner: QueryRunner): Promise<void> {
        await queryRunner.query(`
            ALTER TABLE \`some_entity\`
            DROP INDEX \`IDX_xxxxxx\`; -- 替换成实际的唯一索引名称
            ALTER TABLE \`some_entity\`
            DROP COLUMN \`generatedNumber\`;
        `);
    }
}

这样能完全控制SQL的生成逻辑，避免synchronize模式的不确定性。

备注：内容来源于stack exchange，提问作者hreg