NestJS全局异常过滤器覆盖ValidationPipe校验异常解决方案咨询

解决方案 #

冲突的核心原因是全局无差别捕获的异常过滤器没有正确处理ValidationPipe抛出的校验异常，直接覆盖了校验响应内容，可根据你的业务场景选择以下两种方案：

方案1：调整全局异常过滤器的异常判断逻辑 #

如果你的全局过滤器需要捕获所有类型异常，在异常处理逻辑中新增对ValidationPipe抛出的BadRequestException的特殊处理，提取内置的校验错误信息再返回：

import { ExceptionFilter, Catch, ArgumentsHost, BadRequestException } from '@nestjs/common';
import { Response } from 'express';

@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
  catch(exception: unknown, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();

    // 处理ValidationPipe抛出的参数校验异常
    if (exception instanceof BadRequestException) {
      const status = exception.getStatus();
      const resContent = exception.getResponse();
      
      // 校验异常的响应内容会携带message字段存储错误详情
      if (typeof resContent === 'object' && 'message' in resContent) {
        return response.status(status).json({
          code: status,
          msg: '参数校验失败',
          errors: resContent.message
        });
      }

      // 普通BadRequestException处理逻辑
      return response.status(status).json({
        code: status,
        msg: exception.message
      });
    }

    // 其他类型异常原有处理逻辑
    const status = 500;
    response.status(status).json({
      code: status,
      msg: '服务器内部错误'
    });
  }
}

方案2：限定全局异常过滤器的捕获范围 #

如果你配置全局过滤器只是为了处理自定义业务异常，直接给@Catch()装饰器传入指定的异常类型，过滤器就不会捕获ValidationPipe抛出的系统异常，自然不会产生冲突：

import { ExceptionFilter, Catch, ArgumentsHost } from '@nestjs/common';
import { Response } from 'express';
// 你的自定义业务异常类
import { BusinessException } from './exceptions/business.exception';

// 仅捕获指定的业务异常，跳过系统自带异常的处理
@Catch(BusinessException)
export class BusinessExceptionFilter implements ExceptionFilter {
  catch(exception: BusinessException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse<Response>();
    const status = exception.getStatus();

    response.status(status).json({
      code: exception.code,
      msg: exception.message
    });
  }
}

额外注意 #

如果你自定义了ValidationPipe的exceptionFactory配置，修改了默认抛出的异常类型，需要在过滤器中同步增加对应异常类型的判断逻辑。

内容的提问来源于stack exchange，提问作者Peter Joshua