Clerk Webhook事件触发失败，Vercel返回401认证错误求助

AI 小北

2026-6-26

问题解决方案

核心问题定位

publicRoutes路径配置错误：你写的/app/api/webhooks/clerk/route.ts是本地项目的文件路径，而非实际请求的URL路径，Clerk发送Webhook的目标URL是/api/webhooks/clerk，这导致middleware拦截了Webhook请求并返回401。
根路径/返回401也和路径配置的准确性相关，需同步修正。

具体修复步骤

1. 修正middleware.ts的publicRoutes配置

将Webhook路径改为实际请求的URL路径，修改后的代码：

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

export default authMiddleware({   
  publicRoutes: ['/', '/api/webhooks/clerk'] 
});  

export const config = {   
  matcher: ["/((?!.+\\.[\\w]+$|_next).*)", "/", "/(api|trpc)(.*)"], 
};

2. 确保Webhook端点正确处理请求

在/app/api/webhooks/clerk/route.ts中，必须使用POST方法并验证Clerk签名，示例代码：

import { verifyWebhookSignature } from "@clerk/nextjs/server";
import { NextResponse } from "next/server";

export async function POST(req: Request) {
  const payload = await req.text();
  const signature = req.headers.get("clerk-signature") as string;

  try {
    verifyWebhookSignature({
      secret: process.env.CLERK_WEBHOOK_SECRET!,
      signature,
      payload,
    });

    // 解析事件并写入MongoDB
    const event = JSON.parse(payload);
    // 根据event.type处理用户创建/更新/删除逻辑
    console.log("处理Webhook事件:", event);

    return NextResponse.json({ success: true });
  } catch (err) {
    console.error("签名验证失败:", err);
    return NextResponse.json({ error: "无效签名" }, { status: 400 });
  }
}