NextAuth POST请求中getSession返回null问题求助

问题场景 #

我在集成NextAuth（以Google为认证服务商）和MongoDB时遇到异常：API端点中，GET请求通过getSession能正常获取会话，但POST请求里session始终为null。移除POST接口的请求方法校验后，改用GET访问该接口又能正常拿到会话。

相关代码示例：

getDocs.js（正常工作的GET接口） #

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

export default async function handler(req,res){
    if(req.method!="GET") res.status(400).json({status:"error",msg:"Cannot fulfil GET API request"})

    const session = await getSession({req})
    console.log(session)  // session存在，正常工作

    // 后续代码
}

updateDoc.js（POST接口session为null） #

import { getSession } from "next-auth/react"
import connectDB from "../../../lib/dbconnect/dbconnect"
import Document from "../../../lib/models/document"
import clientPromise from "@/lib/mongodb"

connectDB()

export default async function handler(req,res){
    console.log(req.body)
    
    if(req.method !== "POST")  res.status(400).json({status: "error", msg: "Cannot fulfill GET API request"})

    const session = await getSession({req})
    console.log(session)  // session为null，异常

    // 后续代码
}

api/auth/[...nextauth].js #

import NextAuth from "next-auth"
import GoogleProvider from "next-auth/providers/google"
import clientPromise from "../../../lib/mongodb"
import { MongoDBAdapter } from "@next-auth/mongodb-adapter"

export const authOptions = {
  providers: [
    GoogleProvider({
      clientId: process.env.NEXTAUTH_GOOGLE_CLIENT_ID,
      clientSecret: process.env.NEXTAUTH_GOOGLE_CLIENT_SECRET,
    }),
  ],
  pages:{
    signIn:'/signin'
  },
  adapter: MongoDBAdapter(clientPromise),
}

export default NextAuth(authOptions)

解决方案 #

1. 确保客户端POST请求携带凭证 #

前端发送POST请求时，必须配置携带认证cookie，否则服务器无法读取会话信息。

• 使用fetch的示例：

fetch('/api/updateDoc', {
  method: 'POST',
  credentials: 'include', // 关键配置：携带认证cookie
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify(yourData),
})

• 使用axios的示例：

axios.post('/api/updateDoc', yourData, {
  withCredentials: true, // 关键配置
})

2. 改用getServerSession（推荐服务器端API使用） #

在Next.js API路由中，next-auth/next提供的getServerSession是专为服务器端设计的会话获取方法，比getSession更稳定，适配POST场景。

修改updateDoc.js：

import { getServerSession } from "next-auth/next"
import { authOptions } from "../auth/[...nextauth]" // 导入auth配置
import connectDB from "../../../lib/dbconnect/dbconnect"
import Document from "../../../lib/models/document"
import clientPromise from "@/lib/mongodb"

connectDB()

export default async function handler(req,res){
    console.log(req.body)
    
    if(req.method !== "POST")  res.status(400).json({status: "error", msg: "Cannot fulfill POST API request"})

    const session = await getServerSession(req, res, authOptions) // 使用getServerSession
    console.log(session) // 正常获取会话

    // 后续代码
}

3. 跨域场景补充配置 #

如果前端与API不在同一域名下，需在NextAuth配置中添加CORS允许凭证：
修改api/auth/[...nextauth].js的authOptions：

export const authOptions = {
  // 原有providers、pages、adapter配置不变
  cookies: {
    sessionToken: {
      name: `__Secure-next-auth.session-token`,
      options: {
        httpOnly: true,
        sameSite: 'lax', // 根据场景调整为strict或none
        path: '/',
        secure: process.env.NODE_ENV === 'production',
      },
    },
  },
  cors: {
    origin: process.env.NEXTAUTH_URL, // 你的前端域名，如http://localhost:3000
    credentials: true,
  },
}

4. 修复接口文案错误（非功能性但需修正） #

updateDoc.js中错误提示文案写错了，应把Cannot fulfill GET API request改为Cannot fulfill POST API request，避免混淆。

验证 #

按上述步骤修改后重启项目，测试POST接口即可正常获取session。

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