Next.js 15 结合 NextAuth 5 创建API路由时出现类型错误求助

问题背景 #

使用NextAuth.js 5.0.0-beta.25在Next.js 15.2.4中开发受保护API路由时，构建阶段触发类型错误：路由上下文的params类型（Record<string, string | string[]> | undefined）无法满足NextAuth类型约束要求的Promise<any>类型，导致构建失败。

可行解决方案 #

1. 升级NextAuth到最新Beta版本 #

NextAuth的Beta版本会持续迭代修复框架兼容性问题，优先尝试升级：

npm update next-auth@beta
# yarn 用户执行：
yarn upgrade next-auth@beta

2. 显式指定路由处理函数的官方类型 #

从next/server导入Next.js官方定义的请求和上下文类型，明确参数类型匹配：

import { auth } from "@/auth";
import { NextResponse, NextRequest, NextRouteHandlerContext } from "next/server";

export const GET = auth(async function GET(req: NextRequest, ctx: NextRouteHandlerContext) {
  if (req.auth) return NextResponse.json(req.auth);
  return NextResponse.json({ message: "Not authenticated" }, { status: 401 });
});

3. 临时类型断言（仅紧急场景使用） #

若升级版本无法立即解决，可临时用类型断言绕过检查（不推荐长期使用，避免隐藏潜在问题）：

import { auth } from "@/auth";
import { NextResponse } from "next/server";

export const GET = auth(async function GET(req, ctx: any) {
  if (req.auth) return NextResponse.json(req.auth);
  return NextResponse.json({ message: "Not authenticated" }, { status: 401 });
}) as any;

4. 校验Auth配置文件的类型正确性 #

确保项目根目录的auth.ts（或lib/auth.ts）配置使用正确的类型结构：

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

export const { auth, handlers, signIn, signOut } = NextAuth(authConfig);

验证步骤 #

1. 执行npm run build重新构建项目，确认类型错误消除
2. 启动开发服务器测试API路由的身份验证逻辑是否正常响应

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