NestJS依赖注入报错：无法解析CriticalDataElementService的依赖

我在使用NestJS依赖注入时遇到问题，Nest无法解析CriticalDataElementService的依赖，原因是索引1处的UserService。

错误信息 #

Nest can't resolve dependencies of the CriticalDataElementService (CriticalDataElementRepository, ?, NotificationService, AuditService, OrganizationService). 
Please make sure that the argument UserService at index [1] is available in the CriticalDataElementModule context.

Potential solutions:
- Is CriticalDataElementModule a valid NestJS module?
- If UserService is a provider, is it part of the current CriticalDataElementModule?
- If UserService is exported from a separate @Module, is that module imported within CriticalDataElementModule?
  @Module({
    imports: [ /* the Module containing UserService */ ]
  })

我的配置 #

• CriticalDataElementService依赖多个服务，包括UserService
• UserService定义在独立模块中
• 所有服务均使用@Injectable()且处于各自模块内

已尝试的操作 #

• ✅ 确认UserService在自身模块中并添加@Injectable()
• ✅ 在UserService所在模块导出它，并在CriticalDataElementModule中导入该模块
• ✅ 检查CriticalDataElementModule结构是否正确

解决方案 #

1. 确认模块导出与导入的完整性 #

确保UserService所在模块（如UserModule）正确导出服务：

@Module({
  providers: [UserService],
  exports: [UserService] // 必须显式导出才能被外部模块注入
})
export class UserModule {}

同时验证CriticalDataElementModule导入的是正确的模块：

@Module({
  imports: [UserModule], // 确保此处导入的是包含UserService的模块
  providers: [CriticalDataElementService, CriticalDataElementRepository, NotificationService, AuditService, OrganizationService]
})
export class CriticalDataElementModule {}

2. 检查构造函数参数顺序与装饰器 #

错误提示中UserService位于索引1，确认CriticalDataElementService的构造函数参数顺序与依赖声明一致，若使用自定义令牌需添加@Inject()明确指定：

@Injectable()
export class CriticalDataElementService {
  constructor(
    private readonly cdeRepo: CriticalDataElementRepository,
    private readonly userService: UserService, // 此处对应索引1的位置
    private readonly notificationService: NotificationService,
    // ...其他依赖
  ) {}
}

3. 排查循环依赖 #

若UserService与CriticalDataElementService存在循环依赖，使用forwardRef()解决：
在双方模块导入时添加forwardRef()：

// UserModule
@Module({
  imports: [forwardRef(() => CriticalDataElementModule)],
  providers: [UserService],
  exports: [UserService]
})
export class UserModule {}

// CriticalDataElementModule
@Module({
  imports: [forwardRef(() => UserModule)],
  providers: [CriticalDataElementService]
})
export class CriticalDataElementModule {}

并在服务构造函数中注入时使用：

constructor(
  // ...其他依赖
  @Inject(forwardRef(() => UserService)) private readonly userService: UserService
) {}

4. 清理缓存并重新构建 #

删除项目dist目录，重新执行构建命令，避免缓存文件导致的依赖解析异常。

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