NestJS中TypeORM迁移非增量问题：修改实体重创建表而非ALTER

你的核心问题是开启了synchronize: true，这会和TypeORM的迁移机制冲突，再结合几个常见配置/操作误区，导致迁移总是重建表而非生成增量语句，下面是具体解决步骤：

1. 立即关闭synchronize配置 #

synchronize: true是TypeORM的自动同步模式，它会直接将实体结构同步到数据库，完全绕过迁移机制。开着这个配置时，迁移系统无法正确追踪schema变更历史，自然无法生成增量的ALTER语句。

修改后的DataSource配置：

export const dataSourceOption: DataSourceOptions = {
    type: 'mysql',
    host: 'localhost',
    port: 3306,
    username: 'root',
    password: '',
    database: 'testnestjs',
    entities: ['dist/**/*.entity.js'],
    migrations: ['dist/db/migrations/*.js'],
    synchronize: false, // 必须设为false
}

注意：生产环境绝对不能开启synchronize，可能导致数据丢失。

2. 初始化迁移追踪表 #

TypeORM依赖migrations_metadata表（MySQL中）来记录已执行的迁移，如果这个表不存在，系统会认为没有任何历史迁移，每次生成都会重建全表。

执行以下命令初始化：

# 先生成初始schema迁移
npx typeorm migration:generate -n InitialSchema --dataSource dist/db/data-source.js
# 执行迁移，创建追踪表和初始表结构
npx typeorm migration:run --dataSource dist/db/data-source.js

替换dist/db/data-source.js为你实际的DataSource编译后文件路径。

3. 检查实体定义的正确性 #

如果实体缺少主键或装饰器错误，TypeORM无法识别这是已存在的表：

• 确保每个实体都有@PrimaryGeneratedColumn()或@PrimaryColumn()定义主键
• 字段的装饰器（如@Column()）参数要和数据库类型匹配，避免因类型不匹配被识别为新表

4. 使用正确的迁移生成命令 #

修改实体后，必须用migration:generate命令（而非migration:create），它会对比当前实体和数据库schema，生成增量变更：

npx typeorm migration:generate -n [迁移名称] --dataSource [你的DataSource路径]

例如修改用户实体后生成迁移：

npx typeorm migration:generate -n UpdateUserEntity --dataSource dist/db/data-source.js

生成的迁移文件里就会包含ALTER TABLE语句，而非CREATE TABLE。

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