用 Clerk 管登录后,业务库仍靠轮询用户表——希望 user.created / user.updated 自动同步档案或开通租户,但常踩「事件乱序、重复投递、把 Webhook 当同步阻塞点」。
Clerk Docs《Webhooks overview》(页内 Last updated / dateModified 可核)说明:Clerk Webhooks 让你在用户创建或更新等事件发生时收到 HTTP POST,载荷为 JSON,可用于发通知或更新数据库;它是异步的,看起来近实时,但不能当作注册流程的同步步骤——投递通常很快,但不保证立即或一定送达。Dashboard Webhooks 页可取 signing secret;事件目录见 Event Catalog。投递保证:Clerk/Svix 会重试直至端点返回 2xx 或重试用尽;会尽量去重,但重试仍可能导致同一事件到达多次。事件不保证按发生顺序到达(例如同一用户的 updated 可能先于 created)。文档建议处理器在任意顺序与重复下结果一致,并可用服务端再读代替只依赖载荷顺序。失败时可在 Dashboard 对 Message Attempts 做 Replay。防护上应校验 Svix 签名(可用 verifyWebhook),并可限制仅接受 Svix webhook IP。本场景据此输出同步简报。禁止回显 signing secret 或声称「生产已同步完成」。