NestJS+TypeORM执行migration:run报Unable to open file错误咨询

故障根本原因 #

• TypeOrmModule.forRoot() 中传入的配置仅在NestJS应用启动时由Nest的DI容器加载，TypeORM官方CLI独立运行，不会读取NestJS模块内的配置，所以无参数直接执行typeorm migration:run时，CLI拿不到数据库连接信息、迁移文件匹配规则，自然无法定位迁移文件。
• 命令中-d参数的作用是指定DataSource初始化配置文件的路径，不是指定待执行的单个迁移文件路径。你将迁移TS文件直接传给-d参数后，CLI会尝试把这个文件当作DataSource配置加载，而Node原生运行时无法直接解析TS文件中的ES Module import语法，就抛出了Cannot use import statement outside a module的错误。
• 额外风险提示：当前配置中开启了synchronize: true，该配置会在应用启动时自动根据实体定义修改数据表结构，禁止在生产环境开启，使用迁移流程时建议关闭该选项，避免自动表结构修改和迁移逻辑产生冲突。
• 版本适配说明：TypeORM 0.3.x 版本对CLI逻辑做了破坏性更新，废弃了旧版本自动读取根目录ormconfig配置的逻辑，必须显式传入初始化完成的DataSource实例才能执行所有CLI操作，大部分旧教程的命令没有适配这个变更，是这类问题高发的主要原因。

正确操作步骤 #

1. 在项目根目录创建独立的DataSource配置文件data-source.ts，统一管理数据库连接配置，供NestJS应用和TypeORM CLI共同复用：

import { DataSource } from 'typeorm';

export const AppDataSource = new DataSource({
  type: 'mysql',
  host: 'localhost',
  port: 3306,
  username: 'root',
  password: 'pass',
  database: 'test',
  autoLoadEntities: true,
  entities: ['dist/**/*.entity{.ts,.js}'],
  migrations: ['migrations/*{.ts,.js}'],
  synchronize: false,
});

2. 修改app.module.ts中的TypeORM模块配置，直接引用DataSource的配置项，避免两份配置不一致：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { AppDataSource } from './data-source';
import { CamerasModule } from './cameras/cameras.module';

@Module({
  imports: [
    TypeOrmModule.forRoot(AppDataSource.options),
    CamerasModule
  ],
})
export class AppModule {}

3. 使用正确的命令执行迁移，-d参数指向刚才创建的DataSource配置文件，而非迁移文件本身。TS开发环境下需要借助ts-node提供TS解析能力，直接使用TypeORM内置的适配脚本即可：

npx typeorm-ts-node-commonjs migration:run -d ./data-source.ts

如果是部署场景下运行编译后的JS代码，直接指定编译后的DataSource文件路径即可：

npx typeorm migration:run -d ./dist/data-source.js

4. 后续生成新迁移文件时，同样基于该DataSource配置执行命令即可，示例：

npx typeorm-ts-node-commonjs migration:generate ./migrations/Camera -d ./data-source.ts

内容的提问来源于stack exchange，提问作者Sean Ghaeli