NestJS调用错误HTTP方法时抛出NotFoundException而非MethodNotAllowedException

一、先解决MethodNotAllowedException未触发的问题 #

NestJS默认在路由存在但HTTP方法不匹配时，应该抛出MethodNotAllowedException，如果抛出的是NotFoundException，大概率是路由配置有冲突或者全局前缀影响。

1. 检查全局前缀或路由覆盖 #

如果应用设置了全局前缀（比如app.setGlobalPrefix('api')），实际有效路由是GET /api/cats，此时POST /cats会因找不到对应路由抛出NotFoundException，只有POST /api/cats才会触发方法不允许的异常。先确认请求路径和配置的路由完全匹配。

2. 注册全局MethodNotAllowedException过滤器 #

创建自定义过滤器捕获该异常并返回自定义响应：

import { NestFactory } from '@nestjs/core';
import { AppModule } from './app.module';
import { ExceptionFilter, Catch, ArgumentsHost, HttpStatus } from '@nestjs/common';
import { MethodNotAllowedException } from '@nestjs/common';

@Catch(MethodNotAllowedException)
export class MethodNotAllowedFilter implements ExceptionFilter {
  catch(exception: MethodNotAllowedException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const request = ctx.getRequest();

    response.status(HttpStatus.METHOD_NOT_ALLOWED).json({
      statusCode: HttpStatus.METHOD_NOT_ALLOWED,
      timestamp: new Date().toISOString(),
      path: request.url,
      message: '请求方法不允许，请使用正确的HTTP方法',
    });
  }
}

async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  // 注册全局过滤器
  app.useGlobalFilters(new MethodNotAllowedFilter());
  await app.listen(3000);
}
bootstrap();

二、区分处理NotFoundException和MethodNotAllowedException #

如果已经有处理NotFoundException的全局过滤器，直接将两个过滤器一起注册即可，Nest会自动匹配对应异常类型：

// 已有的NotFoundException过滤器示例
@Catch(NotFoundException)
export class NotFoundFilter implements ExceptionFilter {
  catch(exception: NotFoundException, host: ArgumentsHost) {
    const ctx = host.switchToHttp();
    const response = ctx.getResponse();
    const request = ctx.getRequest();

    response.status(HttpStatus.NOT_FOUND).json({
      statusCode: HttpStatus.NOT_FOUND,
      timestamp: new Date().toISOString(),
      path: request.url,
      message: '请求的路由不存在',
    });
  }
}

// 在main.ts中同时注册两个过滤器
async function bootstrap() {
  const app = await NestFactory.create(AppModule);
  app.useGlobalFilters(new NotFoundFilter(), new MethodNotAllowedFilter());
  await app.listen(3000);
}
bootstrap();

三、验证结果 #

启动服务后：

• 用POST请求/cats，会返回自定义的405响应
• 请求不存在的路由（比如/dogs），会返回自定义的404响应

内容的提问来源于stack exchange，提问作者Mohamed Sallami Rehouma