Next-auth对接自定义后端做身份认证，调用getSession返回undefined如何解决

你遇到的getSession返回undefined是多个配置错误和调用方式错误共同导致的，核心问题如下：

• NextAuth v4版本的session回调参数结构错误，你没有解构入参，导致会话数据没有挂载到正确的返回对象上
• v4版本已经废弃了session: { jwt: true }的配置写法，会话策略未正确生效
• 前端同步调用异步方法getSession，直接解构Promise对象自然拿不到有效数据
• 冗余的session配置写在了Credentials Provider内部，该位置的配置不会生效

1. 修正根配置的会话策略，删除Provider内部的冗余session配置，替换为v4支持的strategy字段：

const options = {
  providers: [
    Credentials({
      name: "Credentials",
      credentials: {
        username: { label: "Username", type: "text" },
        password: { label: "Password", type: "password" }
      },
      // 删掉此处的session配置，移到根配置
      authorize: async (credentials) => {
        // 原有校验逻辑保持不变
      }
    }),
  ],
  session: {
    strategy: "jwt", // v4版本替换原来的jwt: true
    maxAge: 30 * 24 * 60 * 60 // 会话有效期30天
  },
  // 其余原有配置保持不变
}

2. 修正session回调的参数解构和赋值逻辑：

callbacks: {
  async jwt({ token, user }) {
    if (user) {
      return {
        accessToken: user.token.access_token,
        accessTokenExpires: Date.now() + user.token.expire_time * 1000,
        refreshToken: user.token.refresh_token,
        user: user.user,
      }
    }
    return token;
  },
  // 解构入参，获取session和token两个独立对象
  async session({ session, token }) {
    session.user.name = token.user.fullName
    session.accessToken = token.accessToken
    session.refreshToken = token.refreshToken
    return session;
  }
}

3. 修正前端会话获取方式：
   如果是客户端组件，使用useSession钩子获取会话：

import { useSession } from "next-auth/react"

export default function Home() {
  const { data: session, status } = useSession();
  console.log("会话状态：", status, "会话数据：", session)
  return <div></div>
}

如果是服务端逻辑调用，需要用await等待异步方法返回：

const session = await getSession();

4. 确认pages/api/auth/[...nextauth].js的导出逻辑正确：

import NextAuth from "next-auth"
import Credentials from "next-auth/providers/credentials"

// 上面修正后的options配置写在这里

export default NextAuth(options)

完成以上修改后重新启动项目，即可正常获取会话数据。

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