NestJS依赖注入报错：已导入导出模块仍无法解析依赖

问题场景 #

你有两个Nest模块代码如下：

UserModule #

@Module({
  imports: [
    TypeOrmModule.forFeature([User]),
    forwardRef(() => FriendModule),
    forwardRef(() => RequestFriendModule),
  ],
  providers: [UserService],
  controllers: [UserController],
  exports: [UserService],
})
export class UserModule {}

NotificationModule #

@Module({
  controllers: [NotificationController],
  providers: [NotificationService],
  imports: [UserModule],
  exports: [NotificationService],
})
export class NotificationModule {}

NotificationService的构造函数注入了UserService：

constructor(
    private readonly userService: UserService,
 )

运行时出现错误：
Nest can't resolve dependencies of the NotificationService (?). Please make sure that the argument dependency at index [0] is available in the NotificationModule context

你已在UserModule导出UserService，且NotificationModule导入了UserModule，仍出现该错误。

错误原因 #

核心问题是循环依赖。你在UserModule中通过forwardRef导入了FriendModule和RequestFriendModule，而这两个模块很可能又导入了NotificationModule，形成了UserModule → Friend/RequestFriendModule → NotificationModule → UserModule的循环依赖链，导致Nest无法按正常顺序解析UserService的依赖关系。

解决方法 #

1. 在NotificationModule导入UserModule时使用forwardRef
   修改NotificationModule的配置，将UserModule替换为forwardRef(() => UserModule)：

@Module({
  controllers: [NotificationController],
  providers: [NotificationService],
  imports: [forwardRef(() => UserModule)],
  exports: [NotificationService],
})
export class NotificationModule {}

2. 确保循环链中所有模块都正确使用forwardRef
   如果FriendModule或RequestFriendModule确实依赖NotificationModule，那么它们导入NotificationModule时也需要使用forwardRef，示例如下：

@Module({
  imports: [
    forwardRef(() => UserModule),
    forwardRef(() => NotificationModule)
  ],
  // 其他配置项
})
export class FriendModule {}

3. 验证导出配置的正确性
   确认UserModule的exports数组中确实包含UserService，且UserService本身没有其他未正确注入的依赖项，保证服务能被外部模块正常访问。

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