NestJS + TypeORM多数据库连接报错：无法找到default连接

错误原因解析 #

你碰到的Cannot find connection default错误，是因为TypeORM默认会尝试加载名为default的连接，而你的配置中未定义该连接；同时仅在TypeOrmModule.forRoot中指定单个连接名，只会初始化对应连接，其他连接不会被加载。

问题逐一解答 #

1. 是否必须将一个连接命名为"default"？ #

不需要。但如果不设置默认连接，所有涉及TypeORM的操作都必须显式指定连接名，避免依赖默认连接的隐式行为。

2. 是否应在AppModule而非ormconfig.json中定义所有连接？ #

两种方式均可行：

• 用ormconfig.json适合静态配置场景，配置更集中；
• 在AppModule中配置更灵活，支持动态加载、结合环境变量等场景，尤其适合NestJS模块化架构。

3. 多模块间正确使用多连接的方案 #

方案一：基于ormconfig.json的模块独立初始化

1. 保持ormconfig.json中多连接的配置（每个连接有唯一名称）；
2. 不在AppModule中全局初始化TypeORM，而是在每个业务模块中单独初始化对应连接：

   // project1.module.ts
   @Module({
     imports: [
       TypeOrmModule.forRoot({ name: 'project1' }), // 匹配ormconfig中的连接名
       TypeOrmModule.forFeature([Project1Entity], 'project1'), // 绑定实体到该连接
     ],
     controllers: [Project1Controller],
     providers: [Project1Service],
   })
   export class Project1Module {}
   

   // project2.module.ts
   @Module({
     imports: [
       TypeOrmModule.forRoot({ name: 'project2' }),
       TypeOrmModule.forFeature([Project2Entity], 'project2'),
     ],
     controllers: [Project2Controller],
     providers: [Project2Service],
   })
   export class Project2Module {}
   

   每个模块独立管理自己的数据库连接，实现完全隔离。

方案二：AppModule集中初始化所有连接

在根模块统一初始化所有数据库连接，业务模块仅引用对应连接的实体：

// app.module.ts
@Module({
  imports: [
    // 初始化project1连接
    TypeOrmModule.forRoot({
      name: 'project1',
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: '...',
      password: '...',
      database: '...',
      entities: ['src/project1/*.entity.ts'],
      synchronize: false, // 生产环境建议关闭
    }),
    // 初始化project2连接
    TypeOrmModule.forRoot({
      name: 'project2',
      type: 'mysql',
      host: 'localhost',
      port: 3306,
      username: '...',
      password: '...',
      database: '...',
      entities: ['src/project2/*.entity.ts'],
      synchronize: false,
    }),
    Project1Module,
    Project2Module,
  ],
})
export class AppModule {}

业务模块中绑定实体到指定连接：

// project1.module.ts
@Module({
  imports: [TypeOrmModule.forFeature([Project1Entity], 'project1')],
  controllers: [Project1Controller],
  providers: [Project1Service],
})
export class Project1Module {}

服务中注入Repository时指定连接名：

// project1.service.ts
@Injectable()
export class Project1Service {
  constructor(
    @InjectRepository(Project1Entity, 'project1')
    private readonly project1Repo: Repository<Project1Entity>,
  ) {}

  // 业务逻辑示例
  async findAll() {
    return this.project1Repo.find();
  }
}

最佳实践 #

• 模块化隔离：每个业务模块对应一个数据库连接，模块内的实体、服务仅依赖该连接，避免跨模块数据库耦合；
• 禁用默认连接：多数据库场景下，避免设置default连接，强制显式指定连接名，减少潜在混淆；
• 配置分离：将各数据库的配置（如账号、密码）通过环境变量单独管理（例如PROJECT1_DB_USER、PROJECT2_DB_PASSWORD）；
• 迁移独立管理：每个数据库的迁移文件单独存放，使用TypeORM命令指定连接执行迁移：

  # 运行project1的迁移
  typeorm migration:run --connection project1
  # 生成project1的迁移文件
  typeorm migration:generate --connection project1 -n AddUserTable
  

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