NestJS控制器调用第三方API始终返回201 Created问题求助

算力阿峰

2026-7-13

问题原因与解决方案

核心问题

你在控制器里手动调用了subscribe()，这会导致NestJS无法正确处理响应和错误：

控制器方法执行时，subscribe()是异步操作，方法本身同步执行完毕后没有返回任何值，Nest会默认返回201 Created且空响应体
subscribe()回调里的return data不会作为HTTP响应返回，throw new HttpException也不会被Nest的异常过滤器捕获——因为异常是在异步订阅回调中抛出的，脱离了Nest的请求处理上下文

修复方案

NestJS原生支持直接返回Observable，框架会自动帮你完成订阅并处理响应/错误，完全不需要手动调用subscribe()。同时用RxJS的catchError操作符统一处理错误：

修改后的控制器代码

@Controller('auth')
export class AuthController {
  private readonly logger = new Logger();
  constructor(private readonly authService: AuthService) {}

  @Post('')
  authen(@Body() req: AuthDto): Observable<any> {
    return this.authService.authWithHrService(req).pipe(
      tap(data => {
        this.logger.log(`---&gt; authResult :: ${JSON.stringify(data)}`); // 用tap执行日志这类副作用操作，不干扰数据流
      }),
      catchError(err => {
        this.logger.error('认证失败:', err);
        throw new HttpException("Authentication Failed.", HttpStatus.UNAUTHORIZED);
      })
    );
  }
}