TypeScript中TypeOrmModule.forFeature()应传入什么参数？

两种传参方式的适用场景 #

TypeOrmModule.forFeature()的核心作用是向当前模块的依赖注入容器注册可用的仓储实例，支持两类入参，对应完全不同的使用场景：

• 传入实体类：官方默认标准用法，适用于不需要扩展仓储自定义方法、直接使用TypeORM内置Repository通用方法的场景。传入实体后，Nest会自动生成该实体对应的标准仓储实例，默认注入令牌格式为${实体类名}Repository。
  示例写法：

  // 模块注册
  imports: [TypeOrmModule.forFeature([User])],
  // 服务层注入
  constructor(@InjectRepository(User) private readonly userRepository: Repository<User>) {}
  

• 传入自定义仓储类：适用于需要扩展原生Repository、封装业务自定义查询逻辑的场景。注意简单的DataSource => src.getRepository(Wheel)箭头函数不属于可被识别的自定义仓储类，合法的自定义仓储需要继承TypeORM的Repository类并绑定对应实体。传入自定义仓储类后，Nest会注册你扩展后的仓储实例，注入令牌为自定义仓储类本身。
  示例写法：

  // 自定义仓储定义（适配TypeORM 0.2.x版本）
  @EntityRepository(Wheel)
  export class WheelRepository extends Repository<Wheel> {
    // 自定义查询方法
    async findWithRelatedBrand() {
      return this.createQueryBuilder('wheel')
        .leftJoinAndSelect('wheel.brand', 'brand')
        .getMany()
    }
  }
  // 模块注册
  imports: [TypeOrmModule.forFeature([WheelRepository])],
  // 服务层注入
  constructor(private readonly wheelRepository: WheelRepository) {}
  

模块注册与服务层注入的关联逻辑 #

Nest的依赖注入容器是按注入令牌匹配依赖的：forFeature()做的事就是把传入的实体/自定义仓储转换成对应令牌的提供者，注册到当前模块的容器里；服务层@InjectRepository()装饰器做的事是生成要查找的依赖令牌，去容器里找对应实例。
只有两边生成的令牌完全一致时，依赖才能被正确解析，只要令牌不匹配，就会抛出依赖找不到的错误。

报错产生的根本原因 #

混合传参才能运行、替换成实体就报错的现象，核心是注入令牌不匹配：

1. OptionService中写的@InjectRepository(OptionRepository)，会触发装饰器的默认令牌生成逻辑：给传入参数的类名/标识符名追加Repository后缀。因为传入的标识符本身叫OptionRepository，拼接后最终查找的令牌就变成了OptionRepositoryRepository——这也是报错日志里出现奇怪的OptionRepositoryRepository标识的原因。
2. 当forFeature()中传入OptionRepository时，框架注册的提供者令牌刚好和上述拼接后的OptionRepositoryRepository匹配，所以依赖能正常解析，代码可以运行。
3. 当forFeature()里的参数替换为Option实体时，框架注册的是令牌为OptionRepository的标准仓储，和服务层要查找的OptionRepositoryRepository令牌完全不匹配，容器里找不到对应提供者，自然抛出依赖解析错误。
4. Wheel替换后报同类错误也是完全相同的逻辑：服务层注入时传入的是WheelRepository，生成的查找令牌是WheelRepositoryRepository，和传入Wheel实体时注册的WheelRepository令牌不匹配。

修正方案 #

• 如果不需要自定义仓储方法：所有实体直接传入forFeature()，服务层统一使用@InjectRepository(实体类)的形式注入，不要给注入装饰器传带Repository后缀的自定义变量，避免出现重复后缀的令牌错误。
• 如果确实需要自定义仓储：编写符合规范的仓储类，不要用简单的箭头函数工厂，forFeature()中直接传入自定义仓储类，服务层注入时直接引入自定义仓储类作为类型，不需要额外用@InjectRepository()传实体。

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