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工具导航

零沫AI工具导航-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 的异常流、状态码、日志、监控等能力完整生效。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

179

2025.11.26

if什么意思
if什么意思

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

847

2023.08.22

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

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

387

2023.06.29

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

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

2111

2023.08.14

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

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

357

2023.08.31

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

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

259

2023.09.05

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

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

329

2023.10.09

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

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

420

2023.10.16

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

1

2026.03.13

热门下载

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

精品课程

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

共101课时 | 10.2万人学习

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

共39课时 | 3.3万人学习

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

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