NextJs用NextAuth保护API时getServerSideProps/getStaticProps调用返回null问题

算力阿峰

2026-10-6

问题根因

getSession 依赖请求头中的Cookie识别用户会话：

前端组件内调用接口时，浏览器会自动携带当前站点的所有认证Cookie，所以getSession可以正常返回数据
getStaticProps/getServerSideProps 是服务端运行的方法，你在其中发起的fetch请求是服务端侧主动发起的，默认不会携带用户浏览器的Cookie，所以API接口的getSession无法识别到用户，返回null
额外补充：getStaticProps是构建/增量静态再生阶段运行的，本身就不存在当前访问用户的请求上下文，天生不适合请求用户专属的鉴权数据

解决方案

根据你的渲染场景选择对应方案：

场景1：使用getServerSideProps（每次请求动态渲染）

推荐优先选方案1，减少不必要的内部请求开销：

方案1：直接在getServerSideProps内获取会话并执行业务逻辑，不调用内部API

import { getSession } from 'next-auth/client';

export async function getServerSideProps(context) {
  const session = await getSession(context);
  // 未登录直接跳转登录页
  if (!session) {
    return {
      redirect: {
        destination: '/login',
        permanent: false
      }
    }
  }
  // 直接复用业务逻辑获取数据，不需要调用自己的API接口
  const projectService = new ProjectService();
  const projects = await projectService.getUserProjects(session.user.email);

  return {
    props: { projects },
  };
}

方案2：如果必须调用内部API，发起请求时手动携带用户Cookie

export async function getServerSideProps(context) {
  const projects = await fetchApi(`${process.env.BASE_URL}/projects`, {
    headers: {
      Cookie: context.req.headers.cookie || ''
    }
  });

  return {
    props: { projects },
  };
}