Webhook2026年10月14日9 分钟
你的 Webhook 处理程序调用大模型。发送方先挂断了。
Slack 只等 3 秒，Shopify 5 秒，GitHub 10 秒。调用大模型耗时更长，发送方会断开。先应答、后处理，或者让转发服务先把事件保存下来。
最新
14
2026.10
来自 AnyHook 团队的生产实践笔记：投递、重试、签名验证、调试与重放。
ngrok 每次重启都给你一个新 URL，你只好再去 Stripe 或 Shopify 里重新粘贴一遍。在平台那里填一个永久 URL，再把它指向今天的穿透地址。
讨论幂等性，通常以数据库里多出一行告终。到了预约类 Webhook，结局是两个人同时出现在同一个 10:00。
GitHub 不会重试失败的 Webhook 投递，一次都不会。投递记录只保留三天，之后一次出问题的部署就让你永久失去这些事件。
HubSpot 不保证顺序，文档还写明 eventId 不保证唯一。你在 Stripe 的 event.id 上养成的直觉，在这里全都不管用。
漏掉 access.granted，用户会提工单。漏掉 access.revoked，没人会发现：从外面看一切照常。接收端的可用性本身就是一项访问控制。
记录商家（MoR）的 Webhook 回调响应时限更短，重试曲线更密。独立 SaaS 迁到 Paddle 或 Lemon Squeezy 时，哪些地方要改。
Slack 要求三秒内返回 2xx，一小时内 95% 的投递失败就会禁用你的事件订阅。这种 Webhook 故障，用户会亲眼看着它发生。
Twilio 是唯一允许你配置连接超时、读取超时、总时长、重试次数和重试策略的主流发送方，读取超时最长 15 秒。五个旋钮，出厂都带默认值，却没人去拧。
没有 Node crypto，CPU 预算以毫秒计，waitUntil 最多 30 秒且不持久。接收端换成 Worker 之后有哪些不同，来自 AnyHook 自己的接入层。
WooCommerce Webhook 回调靠 Action Scheduler 和 WP-Cron 发出，只在有人访问网站时才运行。连续失败超过五次，Webhook 就会被禁用。
多数主流平台采用至少一次（at-least-once）投递：重复一定会发生，不是例外。四种幂等模式，按保护力度从低到高排列。
十次里有九次是测试 URL 的问题，它只在你盯着画布时才监听。其余原因：响应模式、原始请求体已被解析，或者事件丢失。
Shopify 只给你的端点五秒，四小时内重试八次，然后删除订阅。没有任何报错。订单只是不再进来。
Stripe Webhook 回调端点被禁用，30 天的恢复窗口比听起来要短。顺序：重新启用，再用 Events API 回填。
签名验证莫名失败，waitUntil 的任务凭空消失，冷启动吃掉 Shopify 只给的 5 秒：Serverless 上接收 Webhook 会踩的坑和对策。
轮询浪费请求，但出问题时能平稳降级。Webhook 高效，却会无声地失败。另附大多数像样的集成最终都会搭建的混合方案：Webhook 加对账轮询，最多晚 15 分钟。
半个互联网仍然靠邮件答复：验证码、收据、通知。一次无需密钥的调用，就能给智能体一个真实的收件箱，邮件以 Webhook 事件的形式读回。
一个 catch-all 地址、一个 Worker 邮件处理程序，加上约六十行代码：发到你域名的每封邮件，都变成发往现有 HTTP 管道的 JSON POST。
存在可修改数据库里的 Webhook 日志只是一种说法，不是证据。AnyHook 的事件日志如何变得可验证：按 App 划分的哈希链、每日封存、公开锚点。
如果你的验签测试用验证函数检查的同一个公式来生成签名，两者可能一起错，测试却一直是绿的。我们曾有 70 个这样的测试。拿平台的 SDK 交叉验证。
AI 智能体能调用 API，接收事件却是缺失的另一半。智能体需要 Webhook URL 时会卡在哪里，智能体能自己操作的服务又该是什么样子。
排查 Webhook 投递问题：集成停止工作时，请求头、状态码、耗时和请求体里该看什么，以及 4xx、5xx 和超时分别意味着什么。
为什么简单的指数退避会引发惊群效应，随机抖动（jitter）怎么解决它，以及生产级的重试计划到底长什么样。
服务器宕机了三个小时。Stripe、GitHub 和 Shopify 一直在发 Webhook。漏掉的事件怎么重放，有转发服务和没有转发服务时各怎么做。
ngrok 很适合本地开发，但不是生产方案，免费套餐也只保留 24 小时的流量。本文讲内网穿透之外你还需要什么：预发环境、生产环境，以及两者之间的灰色地带。
Stripe 的 Webhook 回调失败后，会按指数退避最多重试 3 天，然后永久停止。本文讲清重试计划怎么运作、端点宕机时会坏掉什么，以及该如何设计应对。
跨平台的 Webhook 验签：哪里容易出错，时间戳容差怎么起作用，以及重试为什么会让简单的实现失效。