讲师中心 微信公众号

工具推荐

视频效率加速
Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

NestJS 中正确抛出异常以确保 HTTP 状态码准确返回

千萱同学_8318

千萱同学_8318

发布时间:2026-01-09 18:50:03

|

218人浏览过

|

来源于php中文网

原创

NestJS 中正确抛出异常以确保 HTTP 状态码准确返回

在 nestjs 中,若在服务层 `return` 一个 `httpexception` 实例(如 `forbiddenexception`),框架不会自动将其视为异常处理流程,而是序列化为响应体并默认返回 201(post)或 200 状态码;必须使用 `throw` 才能触发异常过滤器并返回正确的 http 状态。

NestJS 的异常处理机制高度依赖异常的抛出(throw)而非返回(return)。当你在服务方法中写 return new ForbiddenException('...'),NestJS 会将该对象当作普通响应数据进行序列化——此时控制器接收到的是一个 JavaScript 对象,而非未捕获的异常,因此全局异常过滤器(如 BaseExceptionFilter)完全不会介入,最终响应状态码由 NestJS 的默认行为决定:对 POST 请求返回 201 Created,其他则多为 200 OK,与业务语义严重不符。

✅ 正确做法是:所有业务校验失败都应 throw 异常,而非 return 异常实例。例如:

HTTP状态码查询
HTTP状态码查询

查询网站的HTTP响应状态码,判断网站是否正常访问、是否重定向、是否存在错误。适用于"HTTP状态码查询""网站状态查询""HTTP状态检测""网页状态码""网站响应码""301重定向查询"等请求。通过本地 Python 脚本调用网站HTTP状态查询接口,并使用环境变量中的专属 API Key。

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

  if (!user) {
    throw new UnauthorizedException('Invalid credentials'); // ✅ 抛出,非返回
  }

  const pwMatches = await argon.verify(user.password, dto.password);
  if (!pwMatches) {
    throw new UnauthorizedException('Invalid credentials'); // ✅ 统一使用 Unauthorized 更语义准确
  }

  return this.signToken(user.id, user.email); // ✅ 正常成功路径返回数据
}

⚠️ 注意事项:

  • ForbiddenException(403)适用于“已认证但无权限”,而登录凭证错误属于“未通过身份验证”,推荐使用 UnauthorizedException(401);
  • catch 块中不应简单 return error,否则异常被吞没;如需兜底处理(如数据库连接失败),应 throw 新异常(如 InternalServerErrorException),并可附加日志:
    } catch (error) {
      this.logger.error(`Login failed for ${dto.email}`, error.stack);
      throw new InternalServerErrorException('Authentication service unavailable');
    }
  • 确保已启用全局异常过滤器(通常 main.ts 中已配置 app.useGlobalFilters(new AllExceptionsFilter())),否则自定义异常可能无法被正确映射。

总结:NestJS 的 HTTP 状态码由异常是否被抛出并被捕获决定,而非由你返回什么对象决定。始终用 throw 触发异常流,让框架统一处理状态码、响应格式与日志,这是构建健壮、符合 REST 规范 API 的关键实践。

热门AI工具

更多
Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

立刻MV
立刻MV Hot

立刻MV是一款AI文本写作工具,AI 音乐视频(MV)创作工具。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

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

1069

2023.10.18

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

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

3460

2023.10.25

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

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

3145

2023.06.29

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

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

4201

2023.08.14

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

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

3551

2023.08.31

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

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

1087

2023.09.05

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

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

3067

2023.10.09

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

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

3047

2023.10.16

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

80

2026.11.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 12.5万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.8万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn