Next Auth V4 JWT回调中account等参数为undefined如何解决

这个问题是NextAuth v3升级v4的典型适配问题，由两个明确的逻辑差异/配置错误导致：

• v4版本调整了jwt回调的参数传递规则：仅用户完成OAuth认证、第一次触发jwt回调的场景，才会传入user/account/profile/isNewUser参数。后续所有会话刷新、token续期、页面访问触发的jwt回调，上述参数默认就是undefined，这是官方的设计逻辑，不是程序bug。
• 你配置了自定义encode/decode方法，这是v3升级场景下的高频故障点：如果自定义编码、解码逻辑没有兼容v4的payload结构，要么在首次编码时丢了认证上下文，要么解码时没有返回完整的token字段，就会出现哪怕首次登录触发jwt回调，也拿不到非token参数的情况。

按以下顺序调整配置即可解决：

1. 调整jwt和session回调逻辑，在首次登录时把需要的字段持久化到token中
   v4不会在后续jwt回调中重复传递认证返回的原始数据，所有需要跨请求保留的Okta用户信息、令牌字段，必须在首次拿到参数时手动挂载到token对象上，再通过session回调透传给前端。参考配置：

callbacks: {
  async jwt({ token, user, account, profile, isNewUser }){
    // account存在时即为首次登录的触发场景
    if (account) {
      // 按需存储你需要的Okta返回字段
      token.accessToken = account.access_token
      token.idToken = account.id_token
      token.oktaUserInfo = profile
      token.accountScope = account.scope
    }
    return token
  },
  async session({ session, token }) {
    // 把token中存储的自定义字段透传到session对象
    session.user.oktaUserInfo = token.oktaUserInfo
    session.accessToken = token.accessToken
    return session
  }
}

2. 排查自定义encode/decode逻辑
   • 如果你不是明确需要自定义jwt的签名、校验规则（只是照搬v3版本的旧配置），直接删除jwt配置下的encode、decode两个自定义字段，使用v4默认的jwt编解码逻辑，绝大多数升级场景下这一步就能直接解决参数丢失问题。
   • 如果确实需要自定义编解码，要保证encode时完整透传传入的payload（不要过滤掉非标准jwt字段），decode时完整返回解析出的所有自定义字段，不能只返回exp、sub这类标准声明。
3. 版本适配校验：确认项目中安装的next-auth版本为v4正式稳定版，没有残留v3版本的适配依赖，同时NextAuth路由配置文件的导出方式符合v4规范，不要保留v3版本的NextAuth()初始化旧写法。

注意：不要试图在非首次登录的jwt回调逻辑中读取user/account/profile参数，v4的设计上就不会在后续请求中传递这些临时数据，所有持久化逻辑必须在首次触发回调时完成。

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