NestJS集成TypeORM报EntityMetadataNotFoundError元数据缺失错误

报错No metadata for "OrganizationsRepository" was found是TypeORM 0.3.x版本迭代导致的兼容性问题：

• 旧版0.2.x中使用的@EntityRepository()装饰器在0.3版本已正式废弃，你代码里看到的装饰器废弃提示就是直接信号
• 之前代码能正常运行，基本是因为依赖锁文件锁定了0.2.x版本，某次依赖安装、升级操作拉取了0.3以上版本后，旧写法的自定义仓库无法被框架识别、加载对应实体元数据，就会抛出该错误。

两种方案都可以正常解决问题，根据现有代码改动量选择即可。

方案1：最小改动适配（保留绝大多数原有逻辑） #

不需要重写已写的业务方法，只需要调整注册和注入逻辑：

1. 移除organizations.repository.ts里废弃的@EntityRepository(Organization)装饰器
2. 给仓库类加@Injectable()装饰器，通过构造函数注入实体对应的基础仓储实例：

// organizations.repository.ts
import { Injectable } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { Organization } from './organization.entity';

@Injectable()
export class OrganizationsRepository {
  constructor(
    @InjectRepository(Organization)
    private readonly baseRepo: Repository<Organization>
  ) {}

  // 原有自定义方法全部保留，内部原来直接调用的this.find()/this.save()等Repository方法
  // 统一改成this.baseRepo.find()/this.baseRepo.save()即可，业务逻辑无需调整
}

3. 在OrganizationsModule中注册实体和自定义仓库：

// organizations.module.ts
@Module({
  imports: [TypeOrmModule.forFeature([Organization])],
  providers: [OrganizationsRepository],
  exports: [OrganizationsRepository] // 其他模块需要调用该仓库就加导出
})
export class OrganizationsModule {}

app.module.ts里已有的autoLoadEntities: true配置保留即可，不需要额外修改全局TypeORM配置。

方案2：采用0.3版本官方自定义仓储写法 #

如果想保留类继承Repository的写法，不用改原有方法内部的this调用，可以通过DataSource手动初始化仓储：

1. 重写仓库类的构造函数，通过DataSource传入实体和实体管理器：

// organizations.repository.ts
import { Injectable } from '@nestjs/common';
import { DataSource, Repository } from 'typeorm';
import { Organization } from './organization.entity';

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

  // 原有自定义方法完全不用改，this.find()/this.create()等原有调用逻辑可以直接保留
}

2. 同样在OrganizationsModule中将该类注册为provider即可，不需要额外加其他装饰器。

• 不要尝试保留旧的@EntityRepository()装饰器，0.3版本下该装饰器没有任何实际逻辑，残留反而会干扰元数据扫描
• 就算开启了autoLoadEntities，自定义仓储用到的实体必须在对应模块的TypeOrmModule.forFeature()中注册，否则框架无法扫描到实体关联关系
• 如果项目配置了文件路径别名，检查tsconfig.json和TypeORM的实体匹配规则是否一致，避免实体文件漏扫

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