0

0

NestJS 中正确抛出异常以确保 HTTP 状态码准确响应

心靈之曲

心靈之曲

发布时间:2026-01-09 14:32:02

|

599人浏览过

|

来源于php中文网

原创

NestJS 中正确抛出异常以确保 HTTP 状态码准确响应

在 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 方法示例:

雪鸮AI
雪鸮AI

高效便捷的智能绘图辅助工具,一键生成高质量效果图。

下载
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 响应

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

408

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

532

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

309

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

74

2025.09.10

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

187

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

271

2023.10.25

http500解决方法
http500解决方法

http500解决方法有检查服务器日志、检查代码错误、检查服务器配置、检查文件和目录权限、检查资源不足、更新软件版本、重启服务器或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

319

2023.11.09

http请求415错误怎么解决
http请求415错误怎么解决

解决方法:1、检查请求头中的Content-Type;2、检查请求体中的数据格式;3、使用适当的编码格式;4、使用适当的请求方法;5、检查服务器端的支持情况。更多http请求415错误怎么解决的相关内容,可以阅读下面的文章。

397

2023.11.14

c++主流开发框架汇总
c++主流开发框架汇总

本专题整合了c++开发框架推荐,阅读专题下面的文章了解更多详细内容。

3

2026.01.09

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 8.2万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.1万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号