NextJS服务端组件调用getToken返回null，客户端正常问题排查

问题排查与解决方案 #

1. 服务端组件中req对象传递错误 #

在Next.js App Router的服务端组件中，不存在传统的req对象，需通过cookies()函数获取用户Cookie再传递给getToken。如果HTTP服务在服务端调用时，rqst变量未正确获取当前请求的Cookie信息，会导致getToken无法读取认证Cookie。

修复方式：
若使用App Router服务端组件，修改getToken调用逻辑：

import { cookies } from 'next/headers';

// 在请求拦截器的服务端执行分支中
const cookieStore = cookies();
const user = await getToken({ 
  cookies: () => cookieStore 
});

若使用Pages Router（如getServerSideProps），需确保传入的req是完整包含cookies属性的请求对象。

2. JWT回调破坏了NextAuth默认Token结构 #

你的jwt回调直接将token替换为{...user, accessToken: user.accessToken}，丢失了NextAuth JWT默认的iat、exp、jti等核心字段，导致getToken验证签名或有效期时失败，返回null。

修复方式：保留默认Token字段，再合并用户信息：

async jwt({ token, user, account, profile, trigger }) {
  if (user) {
    // 合并用户属性而非替换整个token
    token.accessToken = user.accessToken;
    token.id = user.id;
    token.email = user.email;
  }
  return token;
}

3. 服务端环境下NextAuth Secret未正确配置 #

getToken依赖NextAuth的secret验证JWT签名，若服务端环境中secret环境变量未正确加载（如.env文件未被服务端读取、变量名错误），会导致验证失败返回null。

验证方式：
在服务端代码中打印process.env.NEXTAUTH_SECRET，确认其值与authOptions中的secret完全一致。

4. HTTP拦截器在服务端调用时未传递认证上下文 #

服务端组件发起axios请求时，默认不会携带当前用户的Cookie，需手动传递：

// 服务端组件中发起请求时
const cookieStore = cookies();
const response = await httpService.get('/api/xxx', {
  headers: {
    Cookie: cookieStore.toString()
  }
});

额外检查：Cookie的SameSite属性 #

确认NextAuth的Cookie配置中sameSite属性设置合理，确保服务端能正确读取Cookie：

export const authOptions: NextAuthOptions = {
  // ...其他配置
  cookies: {
    sessionToken: {
      name: `next-auth.session-token`,
      options: {
        httpOnly: true,
        sameSite: 'lax',
        path: '/',
        secure: process.env.NODE_ENV === 'production'
      }
    }
  }
};

内容的提问来源于stack exchange，提问作者Burak Öztürk