用途：配置并处理 Clerk Webhook，实现用户生命周期事件与数据同步，以及将 Clerk 与外部系统集成。Clerk 通过 Svix 投递 Webhook，使用 HMAC-SHA256 签名校验；2025 年起 @clerk/backend 提供内置 verifyWebhook() 辅助方法，也可手动使用 Svix。
前提条件：Clerk 账户并在 Dashboard 配置 Webhook 端点；HTTPS 端点（本地开发可用 ngrok）；环境变量 CLERK_WEBHOOK_SECRET（以 whsec_ 开头）。
主要能力：验证 Webhook 签名；处理 user.created、user.updated、user.deleted、organization.created、organizationMembership.created、session.created 等事件；通过 svix-id 实现幂等，避免重复处理；在 Clerk Dashboard 配置端点与订阅事件；支持 Next.js 与 Express 端点；本地用 ngrok 调试。
使用方式：推荐使用 @clerk/backend/webhooks 的 verifyWebhook()，已随 @clerk/nextjs 提供，无需额外安装；手动方式需 npm install svix。Next.js 中必须用 req.text() 读取原始请求体，Express 中必须用 express.raw({ type: 'application/json' })，不可先用 json() 解析，否则签名校验失败。在 Dashboard > Webhooks 添加端点、选择事件并复制签名密钥到 .env.local。本地开发运行 ngrok http 3000，将生成的 HTTPS URL 配置为端点。
限制与注意事项：签名密钥应视为密码，泄露需轮换；Svix 头含 svix-timestamp 用于防重放，默认拒绝超过 5 分钟的事件；高流量应用建议将处理卸载到队列（BullMQ、Inngest、Trigger.dev）并立即返回 200；失败消息会自动指数退避重试，需幂等保护；不要记录签名密钥、原始事件体或不必要的用户属性；确保 /api/webhooks 在中间件 isPublicRoute 中，否则返回 404。
常见错误：Invalid signature 多因密钥错误或请求体被提前 JSON 解析；Missing svix headers 表示请求非来自 Clerk/Svix；重复处理需以 svix-id 为唯一键做幂等；处理超时可将重活放入后台队列。
适用场景：用户同步、认证事件处理、组织与成员同步、与外部系统集成。