NextAuth JWT回调中Account与Profile未定义问题求助

核心原因 #

NextAuth v4 中，jwt 回调的 account 和 profile 参数仅在用户首次登录（通过 OAuth/Credentials 认证）时才会有值，后续每次会话刷新（token 续期）时这两个参数会是 undefined。如果你的代码没区分首次登录和后续刷新的场景，就会误以为参数始终为空。

排查与修复步骤 #

1. 确认认证流程触发时机
   只有用户第一次完成登录授权时，account（包含 OAuth 令牌信息）和 profile（包含第三方平台返回的用户信息）才会被传入 jwt 回调。后续调用 /api/auth/session 刷新会话时，只会传入 token 参数。

2. 检查 Provider 配置
   如果使用 OAuth 提供商（如 Google、GitHub），确保配置了正确的 scope 以获取用户 profile 信息：

   providers: [
     GoogleProvider({
       clientId: process.env.GOOGLE_CLIENT_ID!,
       clientSecret: process.env.GOOGLE_CLIENT_SECRET!,
       scope: 'openid email profile' // 必须包含 profile 才能拿到用户信息
     })
   ]
   

   若使用 Credentials 登录，profile 参数本身就是 undefined，需从 user 参数中获取 Sanity 用户 ID。

3. 修正 jwt 与 session 回调代码
   区分首次登录和后续刷新场景，将 Sanity 用户 ID 存入 JWT 并同步到 Session：

   callbacks: {
     async jwt({ token, user, account, profile }) {
       // 首次登录：从 user 或 profile 中获取 Sanity 用户 ID
       if (user) {
         // 假设 user 中包含从 Sanity 查询到的 id
         token.sanityId = user.sanityId;
       }
       // 若使用 OAuth，也可从 profile 中关联 Sanity 用户（比如通过邮箱查询）
       if (account && profile) {
         // 示例：通过邮箱查询 Sanity 用户并获取 ID
         const sanityUser = await sanityClient.fetch(`*[_type == "user" && email == $email][0]`, { email: profile.email });
         if (sanityUser) token.sanityId = sanityUser._id;
       }
       return token; // 必须返回 token，否则数据会丢失
     },
     async session({ session, token }) {
       // 将 JWT 中的 Sanity ID 同步到 Session
       if (session.user) {
         session.user.sanityId = token.sanityId as string;
       }
       return session;
     }
   }
   

4. 验证回调触发逻辑
   可以在 jwt 回调中添加日志，确认参数何时存在：

   async jwt({ token, user, account, profile }) {
     console.log('JWT Callback:', { user, account, profile });
     // ... 其他逻辑
     return token;
   }
   

   首次登录时会打印 user、account、profile 信息，后续刷新则只会打印 token。

常见误区 #

• 误以为每次调用 jwt 回调都会传入 account 和 profile，忽略了会话刷新的场景。
• OAuth Provider 未配置 profile 权限，导致无法获取用户信息。
• 未在回调中返回 token 或 session，导致自定义字段丢失。

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