Nestjs MiddlewareConsumer的exclude路径配置在Azure函数中不生效问题

问题根因 #

你遇到的是Nest部署到Azure Functions环境下的典型路径匹配问题，本地开发时配置生效但云端失效的核心原因是路径前缀不一致：

1. Azure Functions默认给所有HTTP触发请求追加了/api路由前缀，实际到达Nest中间件的请求路径是/api/validate，和你配置的validate（解析为/validate）无法匹配
2. 如果你额外配置了Nest全局路由前缀，也会导致exclude路径和实际请求路径不匹配
3. 若你使用的@nestjs/core版本低于v8.0.0，低版本的exclude方法本身存在匹配逻辑bug

解决方案 #

方案1：调整exclude路径适配前缀

直接在exclude配置中带上实际的路径前缀即可，示例：

exclude(
  { path: 'api/validate', method: RequestMethod.POST },
)

如果同时配置了Nest全局前缀，比如全局前缀为v1，则路径改为api/v1/validate。

方案2：移除Azure Functions默认路由前缀

修改Azure Functions项目根目录下的host.json配置，清空默认的路由前缀：

{
  "extensions": {
    "http": {
      "routePrefix": ""
    }
  }
}

修改后你原有的exclude配置无需改动即可生效。

方案3：中间件内手动过滤（兼容多环境最优解）

如果需要同时兼容本地开发和Azure部署，避免硬编码前缀带来的维护问题，可以直接在AuthMiddleware中手动过滤要排除的路径：

import { Injectable, NestMiddleware } from '@nestjs/common';
import { Request, Response, NextFunction } from 'express';

export class AuthMiddleware implements NestMiddleware {
  use(req: Request, res: Response, next: NextFunction) {
    // 匹配POST方法且路径以/validate结尾的请求直接跳过中间件逻辑
    if (req.method === 'POST' && req.path.endsWith('/validate')) {
      return next();
    }
    // 原有鉴权逻辑
    // ...
  }
}

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