使用NextAuth创建GraphQL上下文时Session返回undefined求助
我当前使用next@13.4.7和next-auth@4.22.1,基于App Router目录结构搭建了GraphQL端点的API路由,代码如下:
import { startServerAndCreateNextHandler } from "@as-integrations/next"; import { ApolloServer } from "@apollo/server"; import { NextRequest } from "next/server"; import { HttpContext } from "@/server/context"; import { schema } from "@/apollo/schema"; const server = new ApolloServer({ schema, }); const handler = startServerAndCreateNextHandler(server, { context: async (req, res) => { return await HttpContext.init(req, res); }, }); export async function GET(request: NextRequest) { return handler(request); } export async function POST(request: NextRequest) { return handler(request); }
我的HttpContext文件中的init方法用于配置上下文:
static async init(req: IncomingMessage, res: ServerResponse) { const session = await getServerSession(options); console.log("session", session); return new HttpContext(req, res, session); }
问题:访问http://localhost:3000/api/auth/session时浏览器能正常获取完整会话数据,但上述代码中的session变量始终打印为undefined,需要将用户会话附加到GraphQL上下文,以下是解决思路:
修正
getServerSession的参数传递
在App Router环境中,getServerSession需要从next-auth/next导入,并且必须传入请求、响应对象以及完整的authOptions配置(和app/api/auth/[...nextauth]/route.ts中的配置一致)。原代码中仅传入options且参数类型错误,修改后的init方法示例:import { NextRequest, NextResponse } from "next/server"; import { getServerSession } from "next-auth/next"; import { authOptions } from "@/app/api/auth/[...nextauth]/route"; // ... static async init(req: NextRequest, res: NextResponse) { const session = await getServerSession(req, res, authOptions); console.log("session", session); return new HttpContext(req, res, session); }验证请求的Cookie携带情况
检查GraphQL请求的请求头是否包含next-auth.session-token类的会话Cookie:- 如果是客户端发起请求,确保请求配置了
credentials: include(比如Apollo Client或fetch请求中),否则Cookie不会被携带到服务端; - 确认请求是同域发起,跨域场景需要额外配置CORS和Next-Auth的信任域名。
- 如果是客户端发起请求,确保请求配置了
适配App Router的请求对象类型
@as-integrations/next在App Router下传递给上下文的req是NextRequest类型,而非Pages Router的IncomingMessage,原init方法的类型定义错误会导致无法正确解析请求中的Cookie信息,需更新参数类型为NextRequest和NextResponse。检查Next-Auth配置的一致性
确保app/api/auth/[...nextauth]/route.ts中的authOptions正确导出,且secret、会话存储(如数据库适配器)等配置无误,getServerSession依赖该配置来解析会话。调试会话解析过程
在init方法中打印req.headers.cookie,确认是否存在会话Cookie:- 如果没有Cookie,说明客户端请求未携带,需排查请求配置;
- 如果有Cookie但
getServerSession返回undefined,可能是secret不匹配或会话已过期,可尝试重新登录生成新会话。
内容的提问来源于stack exchange,提问作者jhamm

