Next.js App Router中NextAuth获取Session失败的问题求助

问题根源 #

Next.js App Router的API路由采用Web标准的Request/NextResponse对象，而非Pages Router时期的NextApiRequest/NextApiResponse。直接沿用旧写法会导致session解析失败，出现Invalid Compact JWE或res.getHeader is not a function这类错误。

正确实现步骤 #

1. 确保NextAuth版本兼容

使用v4.23.0及以上的NextAuth，该版本开始原生支持App Router环境下的session获取。

2. 导出你的NextAuth配置

在app/api/auth/[...nextauth]/route.ts中导出authOptions，方便其他API路由复用：

// app/api/auth/[...nextauth]/route.ts
import NextAuth from "next-auth";
import CredentialsProvider from "next-auth/providers/credentials";
import { MongoDBAdapter } from "@next-auth/mongodb-adapter";
import clientPromise from "@/lib/mongodb";

export const authOptions = {
  adapter: MongoDBAdapter(clientPromise),
  providers: [
    // 你的登录提供商配置
    CredentialsProvider({
      // ... 你的验证逻辑
    })
  ],
  secret: process.env.NEXTAUTH_SECRET,
  // 其他配置如session策略等
};

const handler = NextAuth(authOptions);
export { handler as GET, handler as POST };

3. 在目标API路由中获取Session

修改你的app/api/newwatchlist/route.ts，使用Web标准Request类型，并直接传入authOptions调用getServerSession：

// app/api/newwatchlist/route.ts
import { getServerSession } from "next-auth/next";
import { authOptions } from "../auth/[...nextauth]/route";
import { NextResponse } from "next/server";

export async function GET(req: Request) {
  // 无需传入req/res，仅需传入authOptions
  const session = await getServerSession(authOptions);

  if (!session) {
    return NextResponse.json({ error: "Unauthorized" }, { status: 401 });
  }

  // 后续业务逻辑，比如使用session.user.id操作数据库
  return NextResponse.json({ message: "Authenticated", user: session.user });
}

常见错误排查 #

• Invalid Compact JWE：检查NEXTAUTH_SECRET环境变量是否正确设置，该值是JWT加密解密的核心，缺失或错误会导致session解析失败。
• res.getHeader is not a function：App Router中不存在旧的NextApiResponse对象，不要强行传入res参数，getServerSession在App Router环境下不需要它。
• session为null：确认用户已登录，且请求携带了正确的session cookie（可在浏览器开发者工具的Application标签查看）。

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