使用NestJS+TypeORM调用entity.save()报错：Connection 'default'未找到

我碰到过好几个开发者踩这个坑，大概率是TypeORM的连接没正确注册到NestJS的模块体系里，或者实体和连接的绑定出了问题。咱们一步步来排查解决：

1. 先确认根模块的TypeORM配置是否到位 #

在你的AppModule（或者其他根模块）里，必须通过TypeOrmModule.forRoot()完成连接初始化，而且配置要准确。比如：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { User } from './user.entity';

@Module({
  imports: [
    TypeOrmModule.forRoot({
      type: 'postgres',
      host: 'localhost',
      port: 5432,
      username: '你的数据库用户名',
      password: '你的数据库密码',
      database: '目标数据库名',
      entities: [User], // 这里一定要包含你要操作的实体类
      synchronize: true, // 开发环境可以开，生产环境记得关掉
    }),
  ],
})
export class AppModule {}

重点注意entities字段：如果这里没包含你要保存的实体，TypeORM就没法把它和default连接关联起来，自然会找不到连接。

2. 子模块要导入TypeOrmModule.forFeature() #

如果你的业务逻辑在子模块（比如UserModule）里，那必须在子模块里导入TypeOrmModule.forFeature([你的实体])，这样NestJS才能把实体和默认连接绑定。示例：

import { Module } from '@nestjs/common';
import { TypeOrmModule } from '@nestjs/typeorm';
import { User } from './user.entity';
import { UserService } from './user.service';

@Module({
  imports: [TypeOrmModule.forFeature([User])],
  providers: [UserService],
})
export class UserModule {}

之后在服务里，建议用@InjectRepository(User)注入仓库来操作数据；如果是用ActiveRecord模式（实体继承BaseEntity），这一步也能确保实体关联到正确的连接。

3. ActiveRecord模式的额外检查 #

如果你习惯直接用entity.save()这种ActiveRecord写法，那要确保实体类要么被包含在根模块的entities数组里，要么显式指定连接名：

import { Entity, Column, PrimaryGeneratedColumn, BaseEntity } from 'typeorm';

@Entity({ name: 'users', connection: 'default' }) // 显式绑定到default连接
export class User extends BaseEntity {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  name: string;
}

4. 异步初始化的情况要处理好 #

如果你的数据库配置是从环境变量或者配置文件异步读取的，必须用TypeOrmModule.forRootAsync()来初始化，不能用同步的forRoot()。示例：

TypeOrmModule.forRootAsync({
  useFactory: () => ({
    type: 'postgres',
    host: process.env.DB_HOST,
    port: +process.env.DB_PORT,
    username: process.env.DB_USERNAME,
    password: process.env.DB_PASSWORD,
    database: process.env.DB_NAME,
    entities: [__dirname + '/**/*.entity{.ts,.js}'], // 用通配符批量加载实体
    synchronize: true,
  }),
})

这种情况下要确认环境变量已经正确加载，不然连接初始化会悄无声息失败，导致后续找不到连接。

5. 手动验证连接状态 #

如果上面几步都没问题，还是报错，可以在服务里注入Connection对象，打印连接状态，看看default连接到底有没有初始化：

import { Injectable, OnModuleInit } from '@nestjs/common';
import { Connection } from 'typeorm';

@Injectable()
export class UserService implements OnModuleInit {
  constructor(private readonly connection: Connection) {}

  async onModuleInit() {
    console.log('当前连接是否已建立：', this.connection.isConnected);
    console.log('所有已注册的连接：', this.connection.manager.connectionManager.connections);
  }
}

如果输出里没有default连接，那说明连接初始化环节出了问题，回到第一步仔细核对数据库地址、端口、凭据这些配置。

总的来说，这个错误的核心就是TypeORM的ConnectionManager里找不到名为default的连接——要么是连接没初始化成功，要么是实体没和这个连接绑定。按照上面的步骤排查，基本都能解决。

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