投递日志与重试机制

报告派发到集成的每一次尝试都会生成一条日志。报告本身永远先落库成功；投递日志回答的是「写进表格那一步发生了什么」。

重试节奏

一次派发 = 1 次首发 + 2 次重试，失败后分别等待 5 秒、15 秒再试（退避重试）。三次全失败才算这次派发失败，并累计到连续失败计数（见自动停用）。

最坏情况下一个集成占用约 20 秒——派发运行在后台线程池，不影响报告提交的响应速度。

字段	说明
`event`	`share.created`（真实报告）/ `test`（测试写入）
`attempt`	第几次尝试（1–3）
`ok`	该次尝试是否成功
`status_code`	对端返回的 HTTP 状态码；网络层失败（连不上 / 超时）为空
`error`	失败原因（截断至 500 字符），如 `http 502: ...`、`network: ConnectTimeout`
`record_id`	成功写入多维表格时的记录 ID（通用 Webhook 无此概念）

成功与失败逐次落库：三次尝试失败会留下三条 ok=false 的记录，各自带当次的错误信息。

控制台 设置 → 集成 → 对应集成的投递记录，按时间倒序，可直接对照「最后成功时间」与「最近错误」两个概要字段。

日志表现	结论	处理
`http 401 / 403`	鉴权问题	方式 B 检查应用凭证与权限范围；通用 Webhook 检查你的验签 / 防火墙
`http 429`	对端限流	飞书接口限流会自动按 fatal 处理，稍后自愈；持续出现联系我们
`http 5xx`	对端故障	通常自愈；连续出现看自动停用
`network: ...`（无状态码）	网络不通 / 超时	检查地址可达性（服务端出口为公网）；通用 Webhook 确认是 https 公网地址
三条失败后无新记录	集成已被自动停用	修复后手动启用

「测试」按钮的每次尝试同样落日志（event=test），但不计入连续失败计数；测试成功会重置计数。