0

0

NestJS 中错误处理:避免返回异常对象导致 HTTP 状态码异常

花韻仙語

花韻仙語

发布时间:2026-01-09 12:22:57

|

700人浏览过

|

来源于php中文网

原创

NestJS 中错误处理:避免返回异常对象导致 HTTP 状态码异常

在 nestjs 中,若在服务层直接 `return` 异常实例(如 `new forbiddenexception()`),框架不会触发异常过滤器,而是将其序列化为响应体,并默认返回 201(post)或 200 状态码,造成鉴权失败却返回成功状态的严重逻辑错误。

这是 NestJS 异常处理机制中一个常见但容易被忽视的关键点:只有被 throw 的异常才会进入 NestJS 的异常处理流程(如全局 ExceptionFilter),进而被正确映射为对应的 HTTP 状态码(如 403);而 return 一个异常对象,仅被视为普通响应数据,框架会照常返回 200/201 状态

以你的登录服务为例:

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) {
    // ⚠️ 注意:此处不应“吞掉”未知异常并静默返回
    // 若此处 return error,则 ForbiddenException 会被当作数据返回,状态码仍是 201
    throw error; // ✅ 建议原样 re-throw,交由全局异常过滤器统一处理
  }
}

最佳实践总结

雪鸮AI
雪鸮AI

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

下载
  • 永远用 throw,而非 return 异常类实例(如 ForbiddenException, UnauthorizedException);
  • 控制器(Controller)应保持简洁,服务(Service)只负责业务逻辑与异常抛出,状态码映射由 NestJS 异常系统自动完成
  • 全局异常过滤器(如 HttpExceptionFilter)可统一格式化错误响应,无需在服务中手动构造错误对象;
  • 若需对特定底层错误(如 Prisma 连接异常、数据库超时)做降级处理,应在 catch 中明确判断并 throw 更语义化的 NestJS 异常(如 new InternalServerErrorException('DB unavailable')),而非返回原始错误。

⚠️ 补充提醒:你原代码中 if (!user) return new ForbiddenException(...) 是典型错误模式——它让 NestJS 把异常当成了合法返回值,导致前端收到 { statusCode: 403, message: '...' } 但 HTTP 状态码却是 201 Created,破坏 RESTful 语义,也使前端拦截逻辑失效(例如 Axios 不会进入 .catch())。

遵循「抛出即处理」原则,才能确保 NestJS 的异常流、状态码、日志、监控等能力完整生效。

相关专题

更多
PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

146

2025.11.26

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

723

2023.08.22

数据库三范式
数据库三范式

数据库三范式是一种设计规范,用于规范化关系型数据库中的数据结构,它通过消除冗余数据、提高数据库性能和数据一致性,提供了一种有效的数据库设计方法。本专题提供数据库三范式相关的文章、下载和课程。

340

2023.06.29

如何删除数据库
如何删除数据库

删除数据库是指在MySQL中完全移除一个数据库及其所包含的所有数据和结构,作用包括:1、释放存储空间;2、确保数据的安全性;3、提高数据库的整体性能,加速查询和操作的执行速度。尽管删除数据库具有一些好处,但在执行任何删除操作之前,务必谨慎操作,并备份重要的数据。删除数据库将永久性地删除所有相关数据和结构,无法回滚。

2072

2023.08.14

vb怎么连接数据库
vb怎么连接数据库

在VB中,连接数据库通常使用ADO(ActiveX 数据对象)或 DAO(Data Access Objects)这两个技术来实现:1、引入ADO库;2、创建ADO连接对象;3、配置连接字符串;4、打开连接;5、执行SQL语句;6、处理查询结果;7、关闭连接即可。

346

2023.08.31

MySQL恢复数据库
MySQL恢复数据库

MySQL恢复数据库的方法有使用物理备份恢复、使用逻辑备份恢复、使用二进制日志恢复和使用数据库复制进行恢复等。本专题为大家提供MySQL数据库相关的文章、下载、课程内容,供大家免费下载体验。

253

2023.09.05

vb中怎么连接access数据库
vb中怎么连接access数据库

vb中连接access数据库的步骤包括引用必要的命名空间、创建连接字符串、创建连接对象、打开连接、执行SQL语句和关闭连接。本专题为大家提供连接access数据库相关的文章、下载、课程内容,供大家免费下载体验。

322

2023.10.09

数据库对象名无效怎么解决
数据库对象名无效怎么解决

数据库对象名无效解决办法:1、检查使用的对象名是否正确,确保没有拼写错误;2、检查数据库中是否已存在具有相同名称的对象,如果是,请更改对象名为一个不同的名称,然后重新创建;3、确保在连接数据库时使用了正确的用户名、密码和数据库名称;4、尝试重启数据库服务,然后再次尝试创建或使用对象;5、尝试更新驱动程序,然后再次尝试创建或使用对象。

406

2023.10.16

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号