NestJS无法解析UserService依赖：循环依赖问题求助

错误原因 #

你遇到的问题是循环依赖未完全处理：虽然在UserModule的imports中使用了forwardRef导入AuthModule，但在UserService注入AuthService时，没有使用forwardRef延迟依赖解析，导致Nest无法在模块初始化阶段解析AuthService的依赖关系。

修复步骤 #

1. 修改UserService的依赖注入 #

在UserService中，导入Inject和forwardRef，并在注入AuthService时使用@Inject(forwardRef(() => AuthService))：

import { Injectable, Inject, forwardRef } from '@nestjs/common';
import { AuthService } from '../auth/auth.service';
import { PrismaService } from '../prisma/prisma.service';

@Injectable()
export class UserService {
  constructor(
    @Inject(forwardRef(() => AuthService))
    private readonly authService: AuthService,
    private readonly prismaService: PrismaService,
  ) {}

  // 其他业务代码
}

2. 确保AuthModule双向处理循环依赖（推荐） #

如果AuthService同样依赖UserService，需要对AuthService做相同处理：

// auth.service.ts
import { Injectable, Inject, forwardRef } from '@nestjs/common';
import { UserService } from '../user/user.service';

@Injectable()
export class AuthService {
  constructor(
    @Inject(forwardRef(() => UserService))
    private readonly userService: UserService,
    // 其他依赖
  ) {}

  // 其他业务代码
}

同时，AuthModule的imports中也建议使用forwardRef导入UserModule，保持双向一致：

// auth.module.ts
@Module({
  controllers: [AuthController],
  providers: [AuthService, GoogleStrategy],
  imports: [
    forwardRef(() => UserModule), // 替换原有的直接导入
    JwtAuthModule,
    PassportModule.register({ defaultStrategy: 'google' }),
  ],
  exports: [AuthService],
})
export class AuthModule {}

3. 清理AppModule冗余导入（可选） #

由于AuthModule已经导入了UserModule，AppModule中不需要同时导入两者，保留一个即可避免模块重复初始化：

// app.module.ts
@Module({
  imports: [
    ConfigModule.forRoot(),
    AuthModule, // 仅保留AuthModule，UserModule会被AuthModule自动导入
    UploadModule,
    ImageModule,
    PrismaModule,
  ],
  providers: [
    {
      provide: APP_PIPE,
      useClass: ValidationPipe,
    },
  ],
})
export class AppModule {}

原理说明 #

NestJS的依赖注入系统在初始化时会按顺序解析模块和服务，循环依赖会导致解析顺序冲突。forwardRef的作用是延迟依赖的解析，让Nest先完成其中一个服务的初始化，再解析另一个，从而打破循环依赖的死锁。

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