如何在Next.js最新版本中用AuthV5在服务端更新Session？

Auth.js V5（原NextAuth.js）已经移除了旧版本中的update导出方法，取而代之的是服务端上下文内的实例方法或专用工具函数，以下是具体实现方式：

方式一：在Server Components/Server Actions中更新 #

首先导入auth函数（而非update）：

import { auth } from "@/auth";

在Server Action中执行Session更新操作：

async function updateUserSession(newUserData) {
  // 获取当前会话
  const session = await auth();
  if (!session) throw new Error("未授权访问");

  // 修改会话中的用户数据
  session.user.name = newUserData.name;
  session.user.email = newUserData.email;

  // 通过auth实例的update方法保存修改
  await auth().update(session);
}

这里的update是auth()返回对象的实例方法，而非直接从@/auth导入的模块方法。

方式二：使用导出的updateSession工具函数 #

先在你的Auth配置文件（通常是app/auth.ts）中导出updateSession：

// app/auth.ts
import NextAuth from "next-auth";
import { authConfig } from "./auth.config";

export const { auth, updateSession } = NextAuth(authConfig);

之后在需要更新Session的服务端代码中导入并使用：

import { auth, updateSession } from "@/auth";

async function modifyUserRole() {
  const session = await auth();
  if (!session) return;

  // 构造更新后的会话对象
  const updatedSession = {
    ...session,
    user: { ...session.user, role: "admin" },
  };

  // 保存更新
  await updateSession(updatedSession);
}

关键注意事项 #

• 所有Session更新操作必须在服务端环境执行（Server Components、Server Actions、API Routes），Client Components无法直接操作
• 执行更新前务必校验Session是否存在，避免未授权操作报错
• 确保你的Auth.js V5配置遵循App Router模式，配置文件放置在app/目录下

内容的提问来源于stack exchange，提问作者أحمد السديري