TypeORM 0.3.17版本应用启动时自动执行迁移失效问题求助

在Docker部署的微服务项目中使用TypeORM 0.3.17版本，除自动执行数据库迁移外其他功能均正常。已在dataSource和typeOrmConfig两个配置文件中设置migrationsRun: true，但该属性未生效，怀疑配置存在遗漏。

dataSource 配置 #

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true,
      envFilePath: './.env',
    }),
    TypeOrmModule.forRootAsync({
      imports: [ConfigModule],
      useFactory: (configService: ConfigService) => ({
        type: 'postgres',
        host: configService.get('POSTGRES_HOST'),
        port: configService.get('POSTGRES_PORT'),
        username: configService.get('POSTGRES_USER'),
        password: configService.get('POSTGRES_PASSWORD'),
        database: configService.get('POSTGRES_DB'),
        ssl: configService.get('NODE_ENV') === 'production' ? true : false,
        autoLoadEntities: true,
        migrations: [`${__dirname}/migrations/*.{ts,js}`],
        entities: [`${__dirname}/libs/shared/src/entities/*.entity.{ts,js}`],
        migrationsTableName: 'migration_table',
        migrationsRun: true,
      }),
      inject: [ConfigService],
    }),
  ],
})
export class PostgresDBModule {}

typeOrmConfig 配置 #

const configService = new ConfigService();

export default new DataSource({
  type: 'postgres',
  host: configService.get('POSTGRES_HOST'),
  port: configService.getOrThrow('POSTGRES_PORT'),
  database: configService.getOrThrow('POSTGRES_DB'),
  username: configService.getOrThrow('POSTGRES_USER'),
  password: configService.getOrThrow('POSTGRES_PASSWORD'),
  ssl: configService.get('NODE_ENV') === 'production' ? true : false,
  migrations: [`${__dirname}/migrations/*.{ts,js}`],
  entities: [`${__dirname}/libs/shared/src/entities/*.entity.{ts,js}`],
  migrationsRun: true,
  migrationsTableName: 'migration_table',
});

排查建议 #

• 校验迁移文件路径：TypeORM 0.3.x对路径解析更严格，Docker环境下编译后的JS文件路径可能与TS文件不一致。建议改用绝对路径或相对dist目录的路径（如dist/migrations/*.js），避免__dirname在编译后指向错误位置。
• 确认配置优先级：NestJS中同时配置TypeOrmModule.forRootAsync和独立DataSource实例可能存在冲突，确保应用启动时实际加载的是带有migrationsRun: true的配置。
• 检查Docker镜像文件结构：进入容器查看migrations目录是否存在，确认Dockerfile中已正确复制migrations文件夹到镜像内。
• 开启日志排查：在配置中添加logging: true，启动时观察日志输出，查看是否有迁移相关的提示（如路径错误、无待执行迁移等）。
• 数据库权限检查：确认数据库用户拥有创建、修改migration_table的权限，权限不足会导致迁移静默失败。

内容的提问来源于stack exchange，提问作者Shlomo Raday