NestJS注入RemoveRoleService至RoleController失败，循环依赖问题求助

问题背景 #

项目包含Role、User、Tenant三个模块，三者互相依赖形成循环依赖。为规避该问题，封装了RemoveRoleService处理原本会引发循环依赖的删除角色逻辑，但始终无法正常运行。

RemoveRoleService代码 #

...
@Injectable()
export class RemoveRoleService {
  constructor(
    private userService: UserService,
    private roleService: RoleService,
  ) { }

  async remove(id: number) {
    const users = await this.userService.getUsers(id, 'role_id');
    if (users.length > 0) {
      throw new BadRequestException({ errorCode: 1035 })
    }
    const user = await this.roleService.remove(id);
    return user
  }
  ...
}

RoleController代码 #

export class RoleController {
  constructor(
    private readonly roleService: RoleService,
    private readonly removeRoleService: RemoveRoleService,
  ) { }
  ...
}

报错信息 #

Nest can't resolve dependencies of the RoleController (RoleService, ?). Please make sure that the argument RemoveRoleService at index [1] is available in the RoleModule context.
Potential solutions:
- Is RoleModule a valid NestJS module?
- If RemoveRoleService is a provider, is it part of the current RoleModule?
- If RemoveRoleService is exported from a separate @Module, is that module imported within RoleModule?
  @Module({
    imports: [ /* the Module containing RemoveRoleService */ ]
  })

当前RoleModule代码 #

import { forwardRef, Module } from '@nestjs/common';
import { RoleService } from './role.service';
import { RoleController } from './role.controller';
import { UseMongoose } from 'src/utils/use-mongoose';
import { Role, RoleSchema } from './schemas/role.schema';
import { RoleMenuModule } from '../roleMenu/roleMenu.module';
import { RemoveRoleService } from './remove-role.service';

@Module({
  imports: [UseMongoose(Role.name, RoleSchema, true), RoleMenuModule],
  controllers: [RoleController],
  providers: [RoleService],
  exports: [RoleService]
})
export class RoleModule { }

解决方案 #

核心问题分析 #

报错直接原因是RemoveRoleService未被注册为RoleModule的提供者，Nest无法在RoleController中解析该依赖。同时，由于RemoveRoleService依赖UserService，而User和Role模块存在循环依赖，必须通过forwardRef处理延迟解析。

具体步骤及修改后代码 #

1. 在RoleModule中注册RemoveRoleService并处理循环依赖
   修改RoleModule，将RemoveRoleService加入providers数组，并通过forwardRef导入UserModule：

import { forwardRef, Module } from '@nestjs/common';
import { RoleService } from './role.service';
import { RoleController } from './role.controller';
import { UseMongoose } from 'src/utils/use-mongoose';
import { Role, RoleSchema } from './schemas/role.schema';
import { RoleMenuModule } from '../roleMenu/roleMenu.module';
import { RemoveRoleService } from './remove-role.service';
import { UserModule } from '../user/user.module'; // 导入UserModule

@Module({
  imports: [
    UseMongoose(Role.name, RoleSchema, true),
    RoleMenuModule,
    forwardRef(() => UserModule), // 使用forwardRef处理与UserModule的循环依赖
  ],
  controllers: [RoleController],
  providers: [RoleService, RemoveRoleService], // 注册RemoveRoleService为提供者
  exports: [RoleService]
})
export class RoleModule { }

2. 修改RemoveRoleService的注入方式
   对UserService的注入使用@Inject(forwardRef(...))装饰器，避免循环依赖报错：

import { Injectable, BadRequestException, Inject, forwardRef } from '@nestjs/common';
import { UserService } from '../user/user.service';
import { RoleService } from './role.service';

@Injectable()
export class RemoveRoleService {
  constructor(
    @Inject(forwardRef(() => UserService)) // 用forwardRef延迟解析UserService
    private userService: UserService,
    private roleService: RoleService,
  ) { }

  async remove(id: number) {
    const users = await this.userService.getUsers(id, 'role_id');
    if (users.length > 0) {
      throw new BadRequestException({ errorCode: 1035 })
    }
    const role = await this.roleService.remove(id); // 修正变量名笔误：user改为role
    return role
  }
}

3. 同步修改UserModule
   在UserModule中同样通过forwardRef导入RoleModule，如果UserService依赖RoleService，也要用@Inject(forwardRef(() => RoleService))注入：

// UserModule示例
import { forwardRef, Module } from '@nestjs/common';
import { UserService } from './user.service';
import { RoleModule } from '../role/role.module';

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

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