Next.js 14导出自定义Middleware后认证功能失效问题排查

正确集成自定义Middleware与NextAuth认证逻辑 #

不要直接替换原有NextAuth的Middleware，而是基于NextAuth的认证逻辑扩展自定义操作，用withAuth包裹你的自定义代码，同时保留认证判断逻辑：

import { withAuth } from "next-auth/middleware";
import { NextResponse } from "next/server";

export default withAuth(
  function middleware(req) {
    // 这里添加自定义头逻辑
    const response = NextResponse.next();
    response.headers.set("X-Custom-Header", "your-custom-value");
    return response;
  },
  {
    callbacks: {
      authorized: ({ token }) => !!token, // 保留原有的认证校验规则
    },
  }
);

// 维持原有的受保护路由配置
export const config = {
  matcher: ["/dashboard/:path*", "/profile/:path*"], // 根据你的实际路由调整
};

修复登录/登出自动重定向问题 #

如果之前用authProvider包裹的方式导致重定向失效，直接替换为上述withAuth的写法即可。核心注意点：

• 不要在自定义逻辑中手动拦截或修改重定向响应，让NextAuth自动处理登录/登出后的跳转流程
• authorized回调仅返回布尔值，不要额外添加重定向逻辑

为什么空Middleware会导致认证失效？ #

Next.js的Middleware是按配置顺序执行的，如果你完全替换了NextAuth原有的Middleware，就等于跳过了所有会话校验逻辑，受保护路由自然失去认证限制，变成公开访问。

额外注意事项 #

• 确保NextAuth版本为最新，避免版本兼容问题
• 检查next.config.js中的experimental字段，确认没有影响Middleware执行的配置
• 测试前清除浏览器缓存与Cookie，避免残留会话导致的异常

内容的提问来源于stack exchange，提问作者Matías Cánepa