投递日志与测试
Webhook 设置面板为每个端点提供内置投递日志。可用它确认事件是否到达服务器、诊断失败,并发送新的示例载荷,无需触发真实活动。
查看投递日志
1
打开设置 → Webhook
前往
Dashboard → Settings → Webhooks.2
展开 Webhook 行
点击 投递日志 按钮,位于任意 Webhook 卡片上。显示最近 50 次投递尝试,最新在前。
3
检查每个条目
每行显示事件类型、HTTP 状态码、响应时间、时间戳和任何错误信息。
日志字段
| 字段 | 描述 |
|---|---|
| 事件 | 触发的事件类型(例如 post.saved) |
| 状态 | 端点返回的 HTTP 状态。 null 如果超时或连接被拒绝。 |
| 响应时间 | 从发送到接收最终响应字节的往返时间,单位为毫秒。 |
| 成功 | 绿色勾号 = HTTP 2xx。红色叉号 = 其他任何结果。 |
| 错误 | 投递失败时便于理解的错误信息(例如 Request timed out (10s)). |
| 送达时间 | 投递尝试的 UTC 时间戳。 |
发送测试事件
1
展开 Webhook 卡片
在
Settings → Webhooks,找到你的 webhook,然后点击 发送测试事件.2
检查投递日志
测试投递会在几秒内出现在投递日志列表顶部。请确认能看到
200 状态。测试事件是真实 HTTP 请求
测试事件与真实事件使用完全相同的处理流程,包括 HMAC 签名。签名验证代码会在测试中完整执行。
不自动重试
每次投递仅尝试一次。日志仅供诊断,失败的实时事件没有重放按钮。修复端点后,请使用“测试”验证修复结果。
常见失败原因
| 错误 / 状态 | 可能原因 | 修复 |
|---|---|---|
Request timed out (10s) | 服务器响应超过 10 秒 | 返回 200 立即响应,然后异步处理 |
401 | 签名验证失败 | 请务必在解析 JSON 前读取原始请求体 |
404 | 端点 URL 路径不存在 | 再次检查 Savebase Webhook 设置中的 URL |
500 | 接收端存在未处理错误 | 查看服务器日志中的异常 |
| 连接被拒绝 / 状态为空 | 服务器宕机或 URL 错误 | 确认服务器正在运行,且可公开访问 |