升级TypeORM 0.3后无实体变更仍生成重复迁移脚本问题

升级TypeORM到0.3.x版本后，首次空库生成迁移正常，但后续无实体修改时，每次生成迁移都会产生大量重复的ALTER TABLE CHANGE语句（如修改deletedAt、各类varchar字段的定义），且该问题持续出现。以下是针对性的解决步骤：

1. 对齐实体与数据库的字段定义细节 #

TypeORM 0.3对字段元数据的校验精度大幅提升，哪怕是细微的定义差异都会被识别为变更：

• 检查实体中字段的nullable配置是否与数据库一致：比如实体里字段显式设置nullable: true，但数据库中字段是NOT NULL，反之亦然。
• 核对字段类型的精度：比如datetime(6)，实体中需显式指定precision: 6，否则TypeORM会默认使用数据库的默认精度（MySQL默认是0），导致与实际数据库字段的精度不匹配。
• 确认varchar字段的长度：实体中如果没指定length，TypeORM默认是255，但如果数据库中字段长度不同，也会触发变更。

2. 统一迁移生成时的实体路径配置 #

当前配置中，生成迁移前先执行build，使用dist下的JS实体，但TypeORM CLI通过ts-node运行，可能存在TS实体与编译后JS实体的元数据不一致问题：

• 修改package.json中的migration:generate命令，去掉build步骤，直接使用TS实体：

  "migration:generate": "npm run typeorm migration:generate src/migrations/YourMigrationName"
  

• 调整.env中的实体路径为TS文件路径：

  # 注释掉原JS路径，改用TS路径
  # TYPEORM_ENTITIES=./dist/**/entities/*.entity.js
  # TYPEORM_MIGRATIONS=./dist/**/migrations/*.js
  TYPEORM_ENTITIES=./src/**/entities/*.entity.ts
  TYPEORM_MIGRATIONS=./src/**/migrations/*.ts
  

  这样TypeORM CLI通过ts-node直接读取TS实体元数据，避免编译过程中可能出现的元数据丢失或不一致。

3. 清除TypeORM元数据缓存 #

TypeORM 0.3可能会缓存实体元数据，导致生成迁移时读取旧的配置：

• 删除项目根目录下的node_modules/.cache目录（如果存在）；
• 重启终端后再执行迁移生成命令，确保读取最新的实体定义。

4. 验证数据库连接类型配置的正确性 #

检查ormconfig.ts中的getConnectionType函数，确保它返回的是正确的数据库类型字符串（如'mysql'）。如果返回值错误，会导致TypeORM对数据库字段的解析逻辑出错，进而误判字段变更。

验证修复效果 #

完成上述调整后，先执行npm run migration:run确保数据库与实体完全同步，再执行migration:generate，此时应该不会再生成多余的ALTER TABLE CHANGE语句。

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