NestJS迁移monorepo后TypeORM报Repository未找到错误

该异常是NestJS monorepo架构下TypeORM实体注册逻辑和单体架构不一致导致，核心触发点有两个：

• monorepo默认构建逻辑（尤其是webpack模式）会做tree-shaking，未被显式import的文件不会进入编译产物，autoLoadEntities: true的递归扫描逻辑失效，无法自动发现实体类
• 你在TypeOrmModule.forFeature()中仅传入了自定义Repository类，未传入对应实体类，@nestjs/typeorm在跨包/跨目录解析时，无法通过@EntityRepository()装饰器反查关联的实体，导致实体未被注册到默认数据库连接，最终抛出仓库找不到的异常。

按优先级操作，第一步改动最小，优先验证：

1. 显式注册实体，不依赖自动扫描 #

在TypeOrmModule.forRoot()配置中，要么显式声明实体匹配路径，要么直接引入实体类注册，彻底绕过自动扫描的不确定性：

// auth.module.ts
import { Users } from './user/entity/user.entity';
import { UserDevice } from './user/entity/user-device.entity';
import { UserLocation } from './user/entity/user-location.entity';
import { UserOTP } from './user/entity/user-otp.entity';
import { UserCredentials } from './user/entity/user-credential.entity';

TypeOrmModule.forRoot({
  type: 'postgres',
  host: process.env.DATABASE_HOST,
  port: parseInt(process.env.DATABASE_PORT),
  username: process.env.DATABASE_USERNAME,
  password: process.env.DATABASE_PASSWORD,
  database: process.env.DATABASE_DB,
  // 直接显式引入所有实体，100%避免扫描失败
  entities: [Users, UserDevice, UserLocation, UserOTP, UserCredentials],
  // 路径匹配方式作为备选，注意生产环境路径要匹配编译后的js文件位置
  // entities: [__dirname + '/**/*.entity.{ts,js}'],
  autoLoadEntities: false, // 关掉不可靠的自动加载
  synchronize: true,
})

2. 修正forFeature传参 #

在UsersModule的TypeOrmModule.forFeature()中，同时传入实体类和自定义Repository，保证模块内实体和仓库的绑定关系正确：

// auth/user/users.module.ts
import { Users } from './entity/user.entity';
import { UserDevice } from './entity/user-device.entity';
import { UserLocation } from './entity/user-location.entity';
import { UserOTP } from './entity/user-otp.entity';
import { UserCredentials } from './entity/user-credential.entity';
import { UsersRepository } from './repository/user.repository';
// 其他Repository的import省略

@Module({
  imports: [
    TypeOrmModule.forFeature([
      // 先传实体类
      Users,
      UserDevice,
      UserLocation,
      UserOTP,
      UserCredentials,
      // 再传自定义Repository
      UsersRepository,
      UserDeviceRepository,
      UserLocationRepository,
      UserOTPRepository,
      UserCredentialRepository,
    ]),
  ],
  providers: [UserService, JwtStrategy, OtpService],
  controllers: [UserController],
  exports: [JwtStrategy, PassportModule],
})
export class UsersModule {}

3. 适配monorepo构建配置 #

如果前两步改完仍报错，检查nest-cli.json的构建配置，关闭webpack打包避免元数据被tree-shaking删除：

{
  "projects": {
    "auth": {
      "type": "application",
      "root": "apps/auth",
      "sourceRoot": "apps/auth/src",
      "compilerOptions": {
        "webpack": false
      }
    }
  }
}

如果必须保留webpack构建，需要在webpack配置中开启externalsPresets: { node: true }，避免Node端模块被过度打包。

4. （可选）升级为新版自定义Repository写法 #

如果你使用的是TypeORM 0.3.x及以上版本，@EntityRepository()装饰器已被废弃，改为基于依赖注入的写法可以彻底避免装饰器元数据丢失问题：

// auth/user/repository/user.repository.ts
import { Injectable } from '@nestjs/common';
import { DataSource, Repository } from 'typeorm';
import { Users } from '../entity/user.entity';
import { SignUpCredentialsDto } from '../dto/signup-credentials.dto';
import { ConflictException, InternalServerErrorException } from '@nestjs/common';
import { UserAccessLevel } from '../enum/user-access-level.enum';

@Injectable()
export class UsersRepository extends Repository<Users> {
  constructor(private dataSource: DataSource) {
    super(Users, dataSource.createEntityManager());
  }

  // 原有业务逻辑保持不变
  async createCustomer(
    signUpCredentialsDto: SignUpCredentialsDto,
  ): Promise<Users> {
    const { phone } = signUpCredentialsDto;

    const customer = this.create({
      phone: phone,
      is_phone_verified: false,
      is_email_verified: false,
      is_complete_profile: false,
      is_suspended: false,
      access_level: UserAccessLevel.CUSTOMER,
    });

    try {
      await this.save(customer);
      return customer;
    } catch (error) {
      if (error.code === '23505') {
        throw new ConflictException('Phone / email already exists');
      } else {
        console.error(error);
        throw new InternalServerErrorException();
      }
    }
  }
}

改完Repository写法后，需要把所有自定义Repository注册到对应模块的providers数组中，需要跨模块使用的同时加到exports数组。

修改完成后先删除根目录和应用目录下的dist缓存文件夹，重新执行启动命令触发全量编译，即可解决实体未注册的问题。

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