NestJS+TypeORM项目MySQL自增ID序列跳号问题求助

问题原因 #

你遇到的ID跳号（间隔30000）是MySQL集群环境下的典型配置问题：为了避免多节点生成重复自增ID，集群通常会设置auto_increment_increment（自增步长）为较大值，auto_increment_offset（起始偏移）为节点序号。同集群的其他项目也出现该问题，换服务后消失，进一步验证了这是集群级别的配置导致。

解决方案 #

1. 检查并修改MySQL自增配置 #

首先登录你的MySQL集群节点，执行以下命令查看当前自增配置：

SHOW VARIABLES LIKE 'auto_increment%';

如果auto_increment_increment的值为30000，那就是跳号的直接原因。

临时修改（重启后失效）

SET GLOBAL auto_increment_increment = 1;
SET GLOBAL auto_increment_offset = 1;

永久修改

在MySQL配置文件（my.cnf或my.ini）中添加以下配置，然后重启服务：

[mysqld]
auto_increment_increment = 1
auto_increment_offset = 1

⚠️ 注意：如果是多主集群，修改为步长1可能导致不同节点生成重复ID，需确认集群架构是否允许单步长，或调整为与节点数匹配的步长（比如3节点集群设步长3）。

2. 切换非自增ID策略（无需修改数据库配置） #

如果无法修改集群配置，可改用以下ID生成方式：

方式一：使用UUID主键

修改Product实体的主键定义：

@PrimaryGeneratedColumn('uuid')
id: string;

优点：无需依赖数据库自增，集群环境无冲突；缺点：UUID查询性能略低于数字ID，且不直观。

方式二：自定义连续ID生成器

创建TypeORM自定义ID生成器，基于单独的序列表来生成连续ID：

1. 创建序列表实体：

@Entity()
export class Sequence {
  @PrimaryColumn()
  name: string;

  @Column()
  value: number;
}

2. 编写ID生成服务：

@Injectable()
export class SequenceService {
  constructor(@InjectRepository(Sequence) private seqRepo: Repository<Sequence>) {}

  async getNextId(name: string): Promise<number> {
    const seq = await this.seqRepo.findOne({ where: { name } });
    if (!seq) {
      await this.seqRepo.save({ name, value: 1 });
      return 1;
    }
    seq.value += 1;
    await this.seqRepo.save(seq);
    return seq.value;
  }
}

3. 在创建产品时手动设置ID：

async create(createProductDto: CreateProductDto): Promise<Product> {
  const nextId = await this.sequenceService.getNextId('product');
  const product = this.productRepository.create({
    ...createProductDto,
    id: nextId
  });
  return this.productRepository.save(product);
}

优点：保证ID连续，不受集群配置影响；缺点：需要额外维护序列表，插入性能略有下降。

3. 优化自定义编码生成逻辑（避免两次保存） #

你提到为生成自定义编码先保存再更新，这其实可以通过MySQL触发器实现，无需两次操作：
创建触发器，在插入产品后自动生成编码（假设新增code字段存储自定义编码）：

DELIMITER //
CREATE TRIGGER generate_product_code AFTER INSERT ON product
FOR EACH ROW
BEGIN
  UPDATE product SET code = CONCAT('PROD-', NEW.id) WHERE id = NEW.id;
END //
DELIMITER ;

然后在Product实体中添加code字段：

@Column({ length: 50, nullable: true })
code: string;

这样插入产品时会自动生成编码，无需手动更新，减少数据库操作。

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