如何在Next-Auth服务端实现程序化登出？

一、使用Next-Auth内置服务端signOut方法 #

在服务端环境（API路由、Server Components、Middleware）中，可直接使用Next-Auth提供的服务端signOut方法，无需调用外部API。

代码示例（自定义API路由） #

// /api/signout-server.js
import { signOut } from "next-auth/server"; // App Router 适用；Pages Router 可导入 next-auth/react 并确保在服务端环境执行

export default async function handler(req, res) {
  // 配置 redirect: false 避免自动跳转，仅处理会话清除
  await signOut({
    redirect: false,
    req,
    res,
  });

  // 返回自定义响应
  res.status(200).json({ message: "登出成功" });
}

注意：若在[...nextauth].js的jwt回调中需触发登出，不建议直接在此执行，应将登出逻辑放在独立业务路由中。若必须处理，可通过设置token为null并配合清除会话Cookie实现，但这种方式不够优雅，优先推荐独立路由方案。

二、正确调用Next-Auth的Signout REST API #

若需通过POST请求调用/api/auth/signout，需携带会话凭证（Cookie或Bearer Token），确保接口能识别当前用户。

代码示例（服务端发起请求） #

// 在自定义API路由或服务端逻辑中调用
export default async function handler(req, res) {
  const signoutRes = await fetch(`${process.env.NEXTAUTH_URL}/api/auth/signout`, {
    method: "POST",
    headers: {
      "Content-Type": "application/x-www-form-urlencoded",
      // 传递当前请求的会话Cookie，确保接口识别用户
      Cookie: req.headers.cookie || "",
      // 若使用Bearer Token认证，需添加此头
      // "Authorization": `Bearer ${req.headers.authorization?.split(' ')[1]}`
    },
    body: new URLSearchParams({
      callbackUrl: process.env.NEXTAUTH_URL, // 可选，指定登出后跳转地址
    }),
  });

  // 将Signout接口的响应头（如清除Cookie的指令）转发给客户端
  signoutRes.headers.forEach((val, key) => res.setHeader(key, val));
  res.status(signoutRes.status).json({ message: "服务端触发登出完成" });
}

关键注意事项 #

• 服务端调用signOut时，必须传入req和res对象，才能正确设置清除会话的Cookie响应头。
• 调用REST API方式登出时，必须携带会话凭证：使用Cookie认证时传递Cookie头；使用Bearer Token时传递Authorization头，否则接口无法识别用户，会返回错误。

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