Next.js 14.1.0中间件未按matcher配置仅在/account路由运行问题

核心问题分析 #

你的中间件在所有路由触发，本质是matcher配置未按预期生效，最常见的原因有两个：

1. 文件位置错误：若middleware.ts放在app文件夹内部，它会被识别为目录级中间件，自动对该目录下所有路由生效，config.matcher配置会被直接忽略。
2. 开发缓存干扰：Next.js开发服务器可能缓存了旧的中间件配置，导致修改后的matcher未实时生效。

解决方案 #

1. 修正文件位置 #

将middleware.ts移动到项目根目录（与app、public文件夹同级），这是全局中间件的正确存放位置，此时config.matcher才会正常生效。

2. 调整matcher配置（按需选择） #

• 仅匹配精确的/account路径：

  export const config = {
    matcher: "/account",
  };
  

• 匹配/account及其所有子路由（如/account/profile、/account/settings）：

  export const config = {
    matcher: "/account/:path*",
  };
  

• 同时匹配多个精确路径（数组形式）：

  export const config = {
    matcher: ["/account", "/dashboard"],
  };
  

3. 重启开发服务器 #

修改配置后，终止当前开发服务并重新执行npm run dev，清除缓存确保新配置生效。

验证方式 #

在中间件开头添加路径日志，确认触发范围：

export async function middleware(request: NextRequest) {
  console.log("中间件触发路径：", request.nextUrl.pathname);
  // 原有JWT验证逻辑...
}

运行后查看终端日志，即可确认中间件仅在目标路径触发。

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