Next.js中如何正确链式调用多中间件？现有实现优化咨询

你的当前实现是正确的，能够满足/dashboard的认证校验和/admin的认证+管理员角色校验需求，但随着路由和权限规则增多，现有代码会逐渐变得臃肿、难以维护。下面是更优的模块化链式中间件实现方案：

核心思路 #

将不同的校验逻辑拆分为独立的中间件单元，通过路由-中间件链的映射关系，让不同路由匹配对应的中间件序列，实现链式执行：前一个中间件通过后，才会执行下一个；若某个中间件返回响应（如重定向、错误提示），则直接终止流程并返回该响应。

优化后的代码实现 #

import { getToken } from "next-auth/jwt";
import { NextResponse } from "next/server";

// 工具函数：获取用户认证token
async function getAuthToken(req) {
  return await getToken({ req });
}

// 工具函数：重定向到首页
function redirectToHome(req) {
  const url = req.nextUrl.clone();
  url.pathname = "/";
  return NextResponse.redirect(url);
}

// 认证中间件：未登录则重定向到首页
async function authMiddleware(req) {
  const token = await getAuthToken(req);
  if (!token) {
    return redirectToHome(req);
  }
  // 将token挂载到req对象，供后续中间件复用
  req.token = token;
  return null; // 返回null表示允许继续执行后续中间件
}

// 管理员角色校验中间件：非管理员返回401错误
async function adminMiddleware(req) {
  const { role } = req.token;
  if (role !== "admin") {
    return new NextResponse(
      JSON.stringify({ success: false, message: "你不是管理员" }),
      { status: 401, headers: { "content-type": "application/json" } }
    );
  }
  return null;
}

// 路由与对应中间件链的映射配置
const routeMiddlewareMap = [
  {
    // 匹配/dashboard及子路径
    paths: ["/dashboard"],
    middlewares: [authMiddleware]
  },
  {
    // 匹配/admin、/random及它们的子路径
    paths: ["/admin", "/random"],
    middlewares: [authMiddleware, adminMiddleware]
  }
];

export async function middleware(req) {
  // 遍历路由映射，找到当前路径匹配的中间件链
  for (const { paths, middlewares } of routeMiddlewareMap) {
    const isMatch = paths.some(path => 
      req.nextUrl.pathname.startsWith(path) || req.nextUrl.pathname === path
    );
    
    if (isMatch) {
      // 依次执行中间件链中的每个中间件
      for (const middlewareFn of middlewares) {
        const response = await middlewareFn(req);
        if (response) {
          // 中间件返回了响应，直接终止流程并返回
          return response;
        }
      }
      // 当前路由的所有中间件都通过，跳出循环继续执行请求
      break;
    }
  }
  
  return NextResponse.next();
}

方案优势 #

• 模块化复用：每个中间件都是独立函数，可单独测试、修改，也能在其他路由规则中复用（比如新增/admin-panel时，直接复用authMiddleware和adminMiddleware）。
• 扩展性强：新增路由或权限规则时，只需在routeMiddlewareMap中添加新的配置条目，无需改动主中间件的核心逻辑。
• 逻辑清晰：链式执行的流程符合直觉，便于追踪每个路由的校验步骤。

额外建议 #

• 若需要更精确的路由匹配（如严格匹配而非前缀匹配），可使用正则表达式替换startsWith判断。
• 可以将工具函数和中间件拆分到单独的文件中（如src/middlewares/auth.js、src/middlewares/admin.js），进一步提升代码结构的清晰度。

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