NextAuth v5 beta中间件类型错误及重复Header问题求助

依赖版本 #

"next": "14.1.0",
"next-auth": "^5.0.0-beta.11",
"next-themes": "^0.2.1",

项目根目录middleware.ts代码 #

import NextAuth from "next-auth";
import authConfig from "@/auth.config";

const { auth } = NextAuth(authConfig);
export default auth((req) => {
  const { nextUrl } = req;
  const isLoggedIn = !!req.auth;
  // 原代码未完成，此处省略后续逻辑
});

类型错误提示 #

鼠标悬停auth((req) =>时出现以下类型错误：

No overload matches this call.
Overload 1 of 4, '(args_0: GetServerSidePropsContext): Promise<Session | null>', gave the following error.
Argument of type '(req: NextAuthRequest) => Response | null' is not assignable to parameter of type 'GetServerSidePropsContext'.
Overload 2 of 4, '(args_0: (req: NextAuthRequest) => void | Response | Promise<void | Response>): AppRouteHandlerFn', gave the following error.
Argument of type '(req: NextAuthRequest) => Response | null' is not assignable to type '(req: NextAuthRequest) => void | Response | Promise<void | Response>'.
Type 'Response | null' is not assignable to type 'void | Response | Promise<void | Response>'.
Type 'null' is not assignable to type 'void | Response | Promise<void | Response>'

额外问题 #

存在无意义重复的中间件Header：{ x-middleware-next: '1' }，已尝试重装node_modules无效。

补充说明 #

此前曾修改node_modules/next-auth/index.d.ts中的NextAuth函数定义，但该类型错误在此修改前已存在。已执行console.log({req})获取请求对象详情。

排查方向与解决方案 #

1. 修复中间件返回值类型问题 #

类型错误核心原因是：NextAuth v5的auth中间件回调函数不允许返回null，只能返回void、Response或对应的Promise类型。

• 检查回调函数逻辑，确保所有分支要么返回Response（比如重定向），要么不返回任何值（直接放行，隐式返回undefined/void）。
• 示例修正：

  export default auth((req) => {
    const { nextUrl } = req;
    const isLoggedIn = !!req.auth;
  
    // 示例：未登录时重定向到登录页
    if (!isLoggedIn && !nextUrl.pathname.startsWith('/login')) {
      return Response.redirect(new URL('/login', nextUrl));
    }
  
    // 无需返回值，直接放行
  });
  

2. 重置NextAuth类型定义 #

由于曾修改过node_modules里的类型文件，即使错误发生在修改前，也可能存在缓存或残留问题：

• 删除node_modules/.cache（Next.js缓存目录）
• 执行npm install重新安装依赖，确保类型文件恢复原始状态
• 重启VS Code的TypeScript服务（快捷键：Ctrl+Shift+P → 选择TypeScript: Restart TS Server）

3. 排查重复Header问题 #

重复的x-middleware-next: '1'通常是中间件逻辑重复执行导致：

• 检查是否在其他文件（如app/middleware.ts或pages/middleware.ts）存在重复的中间件定义
• 确认authConfig中是否配置了额外的中间件逻辑，导致重复触发
• 尝试简化中间件逻辑，只保留核心认证判断，逐步排查是否是某段代码导致的重复Header

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