You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

使用NextAuth创建GraphQL上下文时Session返回undefined求助

Next.js 13 App Router下GraphQL上下文无法获取Next-Auth会话的解决思路

我当前使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.16 11:22:14