最新Next.js版本中ClerkJS auth()/currentUser()服务端使用异常问题

针对你遇到的Clerk auth()/currentUser()在服务端组件/服务端动作中报错的问题，以下是经过验证的解决方案：

1. 修正Middleware配置 #

首先确认你的middleware.ts配置正确，Clerk的authMiddleware需要正确覆盖目标路由，才能将会话信息传递到服务端组件。示例正确配置：

import { authMiddleware } from "@clerk/nextjs";

export default authMiddleware({
  // 配置无需验证的公开路由，比如登录/注册页
  publicRoutes: ["/sign-in", "/sign-up"],
  // 若有Clerk webhook等无需验证的API路由，可添加到ignoredRoutes
  // ignoredRoutes: ["/api/webhooks/clerk"]
});

export const config = {
  // 确保匹配所有非静态资源、Next.js内部路由外的路径，包括API/服务端路由
  matcher: ["/((?!.+\\.[\\w]+$|_next).*)", "/", "/(api|trpc)(.*)"],
};

重点：matcher必须覆盖你调用auth()的页面/路由，否则Clerk无法注入会话信息。

2. 验证环境变量 #

检查.env.local中的Clerk密钥是否正确：

• NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY：Clerk Dashboard中获取的公钥
• CLERK_SECRET_KEY：Clerk Dashboard中获取的密钥
• 确保CLERK_SIGN_IN_URL、CLERK_SIGN_UP_URL配置的路径和你的登录页一致

3. 对齐Clerk与Next.js版本兼容性 #

确保使用的@clerk/nextjs和Next.js版本兼容，建议更新到最新稳定版：

npm update @clerk/nextjs next

4. 服务端组件/动作的正确写法 #

• 服务端组件中必须导入@clerk/nextjs/server中的auth，不能混用客户端的auth方法
• 服务端动作必须添加"use server"指令，确保在服务端执行：

  "use server";
  import { auth } from "@clerk/nextjs/server";
  import { getUserByClerkId } from "@/lib/actions/user/user.get.action";
  
  export async function fetchUser() {
    const { userId } = auth();
    if (!userId) throw new Error("未授权");
    return await getUserByClerkId(userId);
  }
  

5. 清除缓存并重启服务 #

缓存可能导致会话传递异常，执行以下操作后重启开发服务器：

rm -rf .next
npm run dev

6. 检查路由分组匹配 #

如果你的页面在路由分组（如(app)/stories/page.tsx）中，确认middleware的matcher配置能匹配到该路径，默认配置通常会覆盖，但自定义matcher时需注意。

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