NestJS异常抛出与状态码正确设置

目前golang学习网上已经有很多关于文章的文章了，自己在初次阅读这些文章中，也见识到了很多学习思路；那么本文《NestJS 正确抛出异常确保状态码准确》，也希望能帮助到大家，如果阅读完后真的对你学习文章有帮助，欢迎动动手指，评论留言并分享~

在 NestJS 中，直接 `return` 异常实例（如 `new ForbiddenException()`）不会触发异常处理流程，导致响应状态码仍为默认的 201；必须使用 `throw` 才能激活全局异常过滤器并返回正确的 HTTP 状态码。

NestJS 的异常处理机制高度依赖 异常抛出（throw） 而非 异常返回（return）。当你在服务方法中 return new ForbiddenException('...')，NestJS 会将该对象视为普通响应体进行序列化（JSON 化），并沿用当前路由的默认状态码——对 POST 请求即为 201 Created，即使内容是错误信息。

✅ 正确做法：始终使用 throw 抛出异常，让 NestJS 的全局异常过滤器（如内置的 BaseExceptionFilter 或自定义 ExceptionFilter）捕获、日志记录并生成标准化错误响应（含正确状态码、error 字段和可选 timestamp）。

以下是修复后的 login 方法示例：

async login(dto: LoginDto) {
  try {
    const user = await this.prisma.user.findUnique({
      where: { email: dto.email },
    });

    if (!user) {
      throw new ForbiddenException('Credentials incorrect'); // ✅ 抛出，非返回
    }

    const pwMatches = await argon.verify(user.password, dto.password);
    if (!pwMatches) {
      throw new ForbiddenException('Credentials incorrect'); // ✅ 同上
    }

    return this.signToken(user.id, user.email); // ✅ 正常成功路径
  } catch (error) {
    // ⚠️ 注意：此处仅捕获底层异常（如数据库连接失败、Prisma 错误等）
    // 不应吞掉业务逻辑异常（如上面的 ForbiddenException），它们应在 try 内 throw 并透出
    this.logger.error(`Login failed for ${dto.email}:`, error);
    throw new InternalServerErrorException('Login process failed');
  }
}

? 关键注意事项：

• ForbiddenException 属于 NestJS 的标准异常类，继承自 HttpException，抛出后自动映射为 403 Forbidden；
• 不要在 catch 块中“兜底”所有异常并统一 return —— 这会绕过异常过滤器，丧失状态码语义与错误标准化能力；
• 若需自定义错误响应格式（如添加 errorCode 字段），应通过实现 ExceptionFilter 并使用 useGlobalFilters() 注册；
• 全局管道（GlobalPipes）用于请求验证（如 ValidationPipe），不处理异常状态码，异常处理由 ExceptionFilter 负责。

总结：NestJS 的 HTTP 状态码由异常类型决定，而非响应内容。牢记 —— throw 是触发正确状态码的唯一可靠方式；return 永远只产生 200/201 响应。

今天关于《NestJS异常抛出与状态码正确设置》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！