NestJS全局异常过滤器无法捕获JWT Guard抛出的Unauthorized异常求助

看起来你的全局异常过滤器没有正确捕获JWT Guard抛出的UnauthorizedException，反而返回了500内部错误，这大概率是代码语法错误或者全局过滤器注册方式不正确导致的。我们一步步来解决：

1. 先修正代码中的语法错误 #

你提供的过滤器代码里有一行明显的转义错误：

if (typeof res === 'object' && res !== null) {

这里的&&是HTML转义后的字符，实际TypeScript代码中必须改成&&，否则会触发语法错误，导致过滤器在处理HttpException时崩溃，最终 fallback 到500错误。

修正后的这部分逻辑应该是：

if (typeof res === 'object' && res !== null) {
  message = (res as any).message || exception.message;
} else {
  message = res as string;
}

2. 确保全局过滤器的注册方式正确 #

全局异常过滤器必须通过依赖注入的方式注册，才能正确捕获所有模块（包括Guard）抛出的异常。请在**根模块（AppModule）**中通过APP_FILTER提供者完成注册：

// src/app.module.ts
import { Module } from '@nestjs/common';
import { APP_FILTER } from '@nestjs/core';
import { AllExceptionsFilter } from './all-exceptions.filter';
// 导入你的其他业务模块/服务

@Module({
  imports: [/* 你的业务模块 */],
  providers: [
    {
      provide: APP_FILTER,
      useClass: AllExceptionsFilter,
    },
    // 其他服务提供者
  ],
})
export class AppModule {}

注意：不要用app.useGlobalFilters()的方式注册依赖HttpAdapterHost的过滤器——这种方式无法处理依赖注入，会导致过滤器初始化失败，进而无法正常工作。

3. 可选：自定义Unauthorized异常提示 #

如果你想给未授权请求返回更友好的提示信息，可以在过滤器中单独处理UnauthorizedException：

// 在AllExceptionsFilter顶部导入对应异常类
import { UnauthorizedException } from '@nestjs/common';

// ... 其他代码
catch(exception: unknown, host: ArgumentsHost): void {
  const { httpAdapter } = this.httpAdapterHost;
  const ctx = host.switchToHttp();
  const response = ctx.getResponse();
  const request = ctx.getRequest();

  let httpStatus = 500;
  let message = 'Internal server error';

  // 优先处理未授权异常
  if (exception instanceof UnauthorizedException) {
    httpStatus = exception.getStatus();
    message = '身份验证失败，请提供有效的JWT令牌'; // 自定义提示文案
  } else if (exception instanceof HttpException) {
    httpStatus = exception.getStatus();
    const res = exception.getResponse();
    if (typeof res === 'object' && res !== null) {
      message = (res as any).message || exception.message;
    } else {
      message = res as string;
    }
  }

  const responseBody = {
    statusCode: httpStatus,
    timestamp: new Date().toISOString(),
    path: request.url,
    message,
  };

  httpAdapter.reply(response, responseBody, httpStatus);
}

测试验证 #

完成上述修正后，重新启动服务，用Insomnia不带JWT令牌访问受保护接口，应该会返回预期的未授权响应：

{
  "statusCode": 401,
  "timestamp": "2025-06-08T09:15:00.000Z",
  "path": "/user/getUsers",
  "message": "Unauthorized" // 或你自定义的提示文案
}

如果问题仍未解决，可以检查两个点：

• 确认你使用的是@nestjs/passport提供的AuthGuard('jwt')，它确实会抛出UnauthorizedException
• 排查是否有局部过滤器/拦截器覆盖了全局过滤器的异常处理逻辑

内容来源于stack exchange