NextJS中Supabase SSR的getSession始终返回null问题求助

问题场景 #

在NextJS项目的服务端渲染（SSR）流程中，尝试通过两种方式校验用户会话：

• 使用自定义的supabaseService客户端调用auth.getSession()
• 使用@supabase/auth-helpers-nextjs中的createServerSupabaseClient初始化客户端后调用auth.getSession()

两种方式均返回session: null，但客户端实际处于登录状态，且已确认请求上下文的Cookie中存在JWT Cookie。

代码示例：

export async function getServerSideProps(
  context: GetServerSidePropsContext<{ tournamentId: string }>
) {
  // Create authenticated Supabase Client
  const supabaseServ = await supabaseService.auth.getSession();
  const supabase = await createServerSupabaseClient(context);
  // Check if we have a session
  const {
    data: { session },
  } = await supabase.auth.getSession();

  console.log("sessions", supabaseServ, session);
  
  if (!session)
    return {
      redirect: {
        destination: "/",
        permanent: false,
      },
    };
}

可能的原因及解决方法 #

1. supabaseService不适合用于用户会话校验 #

supabaseService作为自定义的服务端客户端，默认不会自动读取请求上下文里的Cookie信息，它更适合做无状态的服务端操作，不能用来获取当前用户的登录会话。

2. createServerSupabaseClient配置异常 #

• 环境变量检查：确认.env.local中NEXT_PUBLIC_SUPABASE_URL和NEXT_PUBLIC_SUPABASE_ANON_KEY配置正确，且服务端能正常读取这两个变量。
• Cookie属性问题：检查Cookie的SameSite、Secure、Path属性是否符合当前场景。跨域场景需设置SameSite=None并开启Secure；同域场景用Lax即可，同时要保证Path覆盖当前页面路径。
• 版本兼容问题：确认@supabase/auth-helpers-nextjs与@supabase/supabase-js版本匹配，版本不兼容会导致会话解析失败。
• 上下文传递完整性：确保createServerSupabaseClient接收的context参数包含完整的req和res对象，不要遗漏任何属性。

3. JWT Cookie有效性问题 #

虽然Cookie存在，但可能JWT已过期、签名无效，或者Cookie名称不匹配。Supabase默认的会话Cookie名称为sb-access-token，可对比确认；也可手动解析JWT验证其有效性。

4. 服务端会话存储配置问题 #

如果使用了自定义服务端会话存储（如Redis），检查存储配置是否正确，能否正常读写会话数据。

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