TypeORM 0.3升级：从Ormconfig迁移到DataSource的正确性确认

针对你升级TypeORM过程中的四个疑问，逐一解答如下：

1. 配置方式是否正确？ #

你的修改方向没问题，但需要补充几个细节确保配置完整：

• data-source.ts的标准结构：文件需导出符合TypeORM 0.3要求的DataSource实例，示例如下：

  import { DataSource } from 'typeorm';
  import { PostgresConnectionOptions } from 'typeorm/driver/postgres/PostgresConnectionOptions';
  import { User } from './entities/user.entity';
  
  const config: PostgresConnectionOptions = {
    type: 'postgres',
    host: 'localhost',
    port: 5432,
    username: 'user',
    password: 'pass',
    database: 'db',
    entities: [User],
    migrations: ['src/migrations/**/*.ts'],
    synchronize: false,
  };
  
  export const AppDataSource = new DataSource(config);
  

• NestJS模块配置：在app.module.ts中，推荐复用data-source.ts的配置，避免重复编写：

  import { Module } from '@nestjs/common';
  import { TypeOrmModule } from '@nestjs/typeorm';
  import { AppDataSource } from './data-source';
  
  @Module({
    imports: [
      TypeOrmModule.forRoot({
        ...AppDataSource.options,
        autoLoadEntities: true, // 自动加载实体，无需手动导入
      }),
    ],
  })
  export class AppModule {}
  

• CLI迁移命令配置：由于0.3版本移除了cli属性，需在package.json中配置迁移命令，指定data-source.ts作为配置入口：

  "scripts": {
    "typeorm": "typeorm-ts-node-commonjs -d ./src/data-source.ts",
    "migration:generate": "npm run typeorm migration:generate src/migrations/Initial",
    "migration:run": "npm run typeorm migration:run"
  }
  

2. @InjectConnection()注入DataSource是否能满足原事务需求？ #

可以满足，但更推荐使用NestJS提供的@InjectDataSource()装饰器（从@nestjs/typeorm导入），语义更明确。事务处理逻辑和原Connection用法基本一致：

import { Injectable } from '@nestjs/common';
import { InjectDataSource } from '@nestjs/typeorm';
import { DataSource } from 'typeorm';
import { User } from './entities/user.entity';

@Injectable()
export class UserService {
  constructor(@InjectDataSource() private readonly dataSource: DataSource) {}

  async createUserWithTransaction() {
    return this.dataSource.transaction(async (manager) => {
      const user = manager.create(User, { name: 'Tom' });
      await manager.save(user);
      // 其他事务内操作
      return user;
    });
  }
}

如果之前用@Transactional()装饰器，需确保依赖的事务库（如typeorm-transactional-cls-hooked）已适配TypeORM 0.3版本。

3. 未使用导出的AppDataSource是否有问题？ #

分两种情况判断：

• 仅用于CLI迁移：如果data-source.ts只是给TypeORM CLI提供配置，应用本身通过NestJS的TypeOrmModule.forRoot()管理数据源，那么无需在应用代码中导入或使用AppDataSource，不会有问题。NestJS会自行创建并管理DataSource实例，和CLI使用的实例相互独立。
• 手动管理数据源：如果没有通过TypeOrmModule配置，打算手动初始化数据源，必须在应用入口（main.ts）调用AppDataSource.initialize()，否则数据库无法连接：

  import { NestFactory } from '@nestjs/core';
  import { AppModule } from './app.module';
  import { AppDataSource } from './data-source';
  
  async function bootstrap() {
    await AppDataSource.initialize(); // 必须调用
    const app = await NestFactory.create(AppModule);
    await app.listen(3000);
  }
  bootstrap();
  

4. 未导入reflect-metadata是否遗漏了必要配置？ #

是的，这是必要配置的遗漏。TypeORM的实体装饰器（如@Entity()）、NestJS的依赖注入装饰器（如@Injectable()、@Module()）都依赖reflect-metadata实现元数据反射。必须在应用入口文件（main.ts）的最顶部导入：

import 'reflect-metadata'; // 必须放在最前面
import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  await app.listen(3000);
}
bootstrap();

如果不导入，即使当前功能看似正常，后续也会出现实体无法识别、依赖注入失败等隐藏bug。

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