NestJS中间件exclude选项未生效，被排除路由仍触发中间件

安全阿岳

2026-9-26

NestJS 中间件exclude排除规则不生效解决方案

以下是对应的排查和修复步骤：

确认中间件注册方式：只有在模块configure方法中通过consumer.apply()注册的模块级中间件支持exclude配置，直接通过app.use()注册的全局中间件无法使用该规则，需要手动在中间件逻辑里判断路由跳过。
确认排除路径的匹配规则：exclude中的路径需要和实际请求的完整路由完全匹配：
1. 如果UserController配置了@Controller('users')前缀，要排除GET类型的/users路由，正确写法如下：
```
import { RequestMethod } from '@nestjs/common';

consumer.apply(YourMiddleware)
  .exclude(
    { path: 'users', method: RequestMethod.GET }
  )
  .forRoutes(YourController);
```
1. 如果你配置了全局路由前缀（如app.setGlobalPrefix('api')），需要把前缀也加入路径：{ path: 'api/users', method: RequestMethod.GET }
2. 注意路径末尾斜杠的匹配问题，如果请求路径带末尾斜杠/users/，需要在exclude里补充对应规则，或者开启Nest的路由自动忽略末尾斜杠配置：
```
const app = await NestFactory.create(AppModule, {
  abortOnError: false,
  forceCloseConnections: true,
  router: {
    strict: false, // 关闭路由严格模式，忽略末尾斜杠
  }
});
```
确认中间件注册顺序：中间件注册逻辑要放在对应路由模块的导入之前，避免路由已经挂载完成才注册中间件导致规则不生效。
确认forRoutes配置没有冲突：如果forRoutes配置的是通配符*或者全控制器匹配，不会影响exclude规则的优先级，只要路径和方法配置正确即可正常排除。