MENU前言常用异常类由nestjs/common提供一常用异常类由nestjs/common提供二示例自定义异常可选自定义响应模块前言在NestJS中nestjs/common提供了大量的内置异常类主要用于在控制器、服务等层抛出特定的HTTP错误响应。常用异常类由nestjs/common提供一序号异常类状态码说明01BadRequestException400客户端请求参数错误、验证失败02UnauthorizedException401未授权常用于认证失败账号/密码错误、token无效等03ForbiddenException403无权限访问即使已认证04NotFoundException404找不到资源如用户不存在05MethodNotAllowedException405不允许的请求方法06NotAcceptableException406请求格式不可接受比如响应类型不被支持07RequestTimeoutException408请求超时08ConflictException409资源冲突如重复注册、唯一索引冲突09GoneException410资源已被永久删除10PayloadTooLargeException413请求体过大文件上传11UnsupportedMediaTypeException415不支持的媒体类型如上传类型错误12UnprocessableEntityException422语义错误、验证失败用于复杂验证13InternalServerErrorException500服务端错误14NotImplementedException501接口未实现15BadGatewayException502网关错误16ServiceUnavailableException503服务不可用服务器维护、宕机等17GatewayTimeoutException504网关超时常用异常类由nestjs/common提供二序号异常类状态码说明使用场景示例01BadRequestException400客户端请求参数错误、验证失败表单必填字段缺失、参数格式不正确、验证码错误02UnauthorizedException401未授权常用于认证失败登录失败账号/密码错误、Token 无效或过期03ForbiddenException403无权限访问即使已认证用户已登录但没有访问某个资源的权限例如普通用户访问管理员接口04NotFoundException404找不到资源查询用户、文章或其他资源不存在05MethodNotAllowedException405不允许的请求方法接口只允许 POST但用户使用 GET 请求06NotAcceptableException406请求格式不可接受客户端请求Accept: application/xml但服务器只返回 JSON07RequestTimeoutException408请求超时客户端长时间未发送完整请求数据服务器关闭连接08ConflictException409资源冲突重复注册账号、邮箱已存在、更新资源版本冲突09GoneException410资源已被永久删除某条数据已被删除且不可恢复例如已注销的用户账户10PayloadTooLargeException413请求体过大上传文件过大或一次性发送的数据超过服务器限制11UnsupportedMediaTypeException415不支持的媒体类型客户端上传image/gif服务器只支持image/png12UnprocessableEntityException422语义错误、验证失败表单验证通过但逻辑上不允许例如生日大于当前日期13InternalServerErrorException500服务端错误数据库异常、第三方服务报错、未捕获异常14NotImplementedException501接口未实现客户端调用了服务器未开发的接口15BadGatewayException502网关错误服务器作为代理请求上游服务失败例如 Nginx 访问后端接口失败16ServiceUnavailableException503服务不可用服务器维护或宕机、负载过高无法处理请求17GatewayTimeoutException504网关超时服务器作为代理请求上游服务超时未响应示例import{BadRequestException,UnauthorizedException,NotFoundException,ConflictException,}fromnestjs/common;if(!user)thrownewNotFoundException(用户不存在);if(!isPasswordValid)thrownewUnauthorizedException(账号或密码错误);if(emailAlreadyUsed)thrownewConflictException(该邮箱已被注册);if(!dto.name)thrownewBadRequestException(用户名不能为空);自定义异常可选可以继承HttpException自定义import{HttpException,HttpStatus}fromnestjs/common;thrownewHttpException(自定义错误信息,HttpStatus.BAD_REQUEST);封装成一个类exportclassCustomExceptionextendsHttpException{constructor(){super(这是一个自定义异常,HttpStatus.I_AM_A_TEAPOT);}}自定义响应模块敬请期待…