NestJs + TypeORM迁移异常：MySQL未生成用户/报告数据表

一、先确认数据库连接配置 #

1. 检查TypeORM配置是否正确指向MySQL：
   • 驱动必须是mysql2（需提前执行npm install mysql2安装）
   • 手动创建好目标MySQL数据库（TypeORM不会自动建库，只会在已存在的库中建表）
   • 确保synchronize设为false（迁移模式下不能开启自动同步，否则会干扰迁移变更检测）
   • 示例配置：

     // app.module.ts 或 ormconfig.ts
     TypeOrmModule.forRoot({
       type: 'mysql',
       host: 'localhost',
       port: 3306,
       username: 'root',
       password: 'your-db-password',
       database: 'report-app', // 已手动创建的数据库名称
       entities: [__dirname + '/**/*.entity{.ts,.js}'], // 确保覆盖所有实体文件路径
       migrations: [__dirname + '/migrations/**/*{.ts,.js}'],
       synchronize: false,
       migrationsRun: false,
       cli: {
         migrationsDir: 'src/migrations',
       },
     })
     

二、验证实体类配置 #

1. 确保实体类正确导入typeorm的装饰器，且@Entity()装饰器未遗漏：

   // user.entity.ts
   import { Entity, PrimaryGeneratedColumn, Column } from 'typeorm';
   
   @Entity()
   export class User {
     @PrimaryGeneratedColumn()
     id: number;
   
     @Column()
     username: string;
   
     // 其他业务字段...
   }
   

2. 确认实体文件路径被entities配置正确覆盖，避免TypeORM找不到实体导致无法检测架构变更。

三、修正迁移命令 #

1. 检查package.json的脚本配置，根据项目模块类型（CommonJS/ESM）设置正确的TypeORM命令：

   {
     "scripts": {
       // CommonJS项目使用
       "migration:generate": "typeorm-ts-node-commonjs migration:generate",
       "migration:run": "typeorm-ts-node-commonjs migration:run",
       // ESM项目使用下面的命令
       // "migration:generate": "typeorm-ts-node-esm migration:generate",
       // "migration:run": "typeorm-ts-node-esm migration:run"
     }
   }
   

2. 生成迁移时必须指定具体的迁移文件名，不能只写目录：

   npm run migration:generate -- src/migrations/InitUsersAndReportsTables
   

   之前只指定目录的写法会导致TypeORM无法生成有效迁移文件，后续执行migration:run自然找不到待执行的迁移。

四、清理迁移记录 #

MySQL中TypeORM会自动创建migrations表记录已执行的迁移，若该表存在旧记录（比如从SQLite迁移过来的残留），会导致TypeORM误判无新变更：

• 进入MySQL，删除migrations表，再重新生成迁移。

五、清除缓存与编译残留 #

1. 删除dist目录（TS编译后的JS文件），避免旧代码干扰检测
2. 若项目根目录存在.typeorm-cache文件，直接删除清除缓存

六、分步测试流程 #

1. 手动创建目标MySQL数据库
2. 写简单测试代码验证数据库连接是否正常（比如用getRepository(User).find()）
3. 删除src/migrations下所有旧文件
4. 执行正确的迁移生成命令
5. 执行npm run migration:run
6. 查看MySQL Workbench确认表是否生成

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