Nest调用PersonService出现依赖解析错误，请求排查代码问题

错误原因 #

1. 重复声明服务导致依赖解析失败
   在OrganizationModule的providers数组中直接声明了PersonService和UsersService，但实际上已经通过forwardRef(() => PersonModule)和forwardRef(() => UsersModule)导入了对应模块，且这些模块已经导出了各自的服务。重复声明会让Nest尝试创建全新的服务实例，而这个新实例的依赖（比如PersonService所需的UsersService）无法在当前模块上下文正确解析，从而出现依赖缺失的错误。

2. 循环依赖处理逻辑被破坏
   由于PersonModule和UsersModule之间存在循环依赖（通过forwardRef导入体现），直接在外部模块的providers中声明服务会绕过Nest的循环依赖处理机制，导致依赖注入链断裂。

修复步骤 #

步骤1：清理OrganizationModule的providers数组 #

修改Organization.module.ts，移除providers中的UsersService和PersonService：

@Module({
  imports: [
    RateLimiterModule.register({ type: 'Memory', points: 100, duration: 60 * 5, keyPrefix: 'organization'  }),
    MongooseModule.forFeature([ 
      { name: 'Organization', schema: OrganizationSchema },
      { name: 'User', schema: UserSchema },
      { name: 'Person', schema: PersonSchema },
    ]),
    PassportModule.register({ defaultStrategy: 'jwt', session: false }),
    forwardRef(() => UsersModule),
    forwardRef(() => PersonModule),
  ],
  exports: [OrganizationService],
  controllers: [OrganizationController],
  providers: [OrganizationService] // 移除UsersService和PersonService
})

步骤2：确保PersonService的循环依赖注入正确 #

检查PersonService的构造函数，如果依赖UsersService，必须使用@Inject(forwardRef)装饰器，示例如下：

@Injectable()
export class PersonService {
  constructor(
    @InjectModel('Person') private readonly personModel: Model<Person>,
    @Inject(forwardRef(() => UsersService)) // 必须添加这个装饰器处理循环依赖
    private readonly usersService: UsersService
  ) {}
}

原理说明 #

Nest的模块系统中，导入模块并使用其导出的服务是规范的依赖注入方式。当存在循环依赖时，forwardRef需要同时作用于模块导入和服务构造函数的注入装饰器，才能正确建立依赖链。直接在外部模块声明其他模块的服务会打破这种机制，导致Nest无法找到正确的依赖实例。

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