服务端之nestJS常用异常类及封装自定义响应模块

MENU

• 前言
• 常用异常类（由@nestjs/common提供）
• 示例
• 自定义异常（可选）
• 自定义响应模块

---

前言

在NestJS中，@nestjs/common提供了大量的内置异常类，主要用于在控制器、服务等层抛出特定的HTTP错误响应。

---

常用异常类（由@nestjs/common提供）

序号	异常类	状态码	说明
01	BadRequestException	400	客户端请求参数错误、验证失败
02	UnauthorizedException	401	未授权，常用于认证失败（账号/密码错误、token无效等）
03	ForbiddenException	403	无权限访问（即使已认证）
04	NotFoundException	404	找不到资源（如用户不存在）
05	MethodNotAllowedException	405	不允许的请求方法
06	NotAcceptableException	406	请求格式不可接受（比如响应类型不被支持）
07	RequestTimeoutException	408	请求超时
08	ConflictException	409	资源冲突（如重复注册、唯一索引冲突）
09	GoneException	410	资源已被永久删除
10	PayloadTooLargeException	413	请求体过大（文件上传）
11	UnsupportedMediaTypeException	415	不支持的媒体类型（如上传类型错误）
12	UnprocessableEntityException	422	语义错误、验证失败（用于复杂验证）
13	InternalServerErrorException	500	服务端错误
14	NotImplementedException	501	接口未实现
15	BadGatewayException	502	网关错误
16	ServiceUnavailableException	503	服务不可用（服务器维护、宕机等）
17	GatewayTimeoutException	504	网关超时

---

示例

import {
  BadRequestException,
  UnauthorizedException,
  NotFoundException,
  ConflictException,
} from '@nestjs/common';

if (!user) throw new NotFoundException('用户不存在');
if (!isPasswordValid) throw new UnauthorizedException('账号或密码错误');
if (emailAlreadyUsed) throw new ConflictException('该邮箱已被注册');
if (!dto.name) throw new BadRequestException('用户名不能为空');

---

自定义异常（可选）

可以继承HttpException自定义

import { HttpException, HttpStatus } from '@nestjs/common';

throw new HttpException('自定义错误信息', HttpStatus.BAD_REQUEST);

---

封装成一个类

export class CustomException extends HttpException {
  constructor() {
    super('这是一个自定义异常', HttpStatus.I_AM_A_TEAPOT);
  }
}

---

自定义响应模块

敬请期待...