Source: https://tgdog.wadesk.io/zh/guide/troubleshooting/

[首页](https://tgdog.wadesk.io/zh/)/ [指南](https://tgdog.wadesk.io/zh/guide/)/ 数据与故障排查 数据与故障排查

# 排查更新缺失与 Telegram API 错误

诊断匹配遗漏、接收冲突、速率限制与未知动作结果。

[TGDog产品文档](https://tgdog.wadesk.io/zh/about/)发布于 2026年10月9日 更新于 2026年10月9日 2 分钟阅读

阅读要点
- 调整规则前，先检查消息接收与豁免。

- 409 表示接收冲突；429 需要等待。

- 清理本地数据前，先处理未知动作结果。

## [遇到问题时，从这里检查。](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E9%81%87%E5%88%B0%E9%97%AE%E9%A2%98%E6%97%B6%E4%BB%8E%E8%BF%99%E9%87%8C%E6%A3%80%E6%9F%A5)

### [未收到消息](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E6%9C%AA%E6%94%B6%E5%88%B0%E6%B6%88%E6%81%AF)

确认 Chrome 正在运行并联网、Token 有效、机器人是超级群管理员。检查是否有其他客户端或 Webhook 接收更新。机器人可见的消息由 Telegram 决定，不能假定它能收到所有类型的消息。

### [关键词似乎漏检](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E5%85%B3%E9%94%AE%E8%AF%8D%E4%BC%BC%E4%B9%8E%E6%BC%8F%E6%A3%80)

检查群管理和关键词规则是否开启、发送者是否被豁免、消息是否存在于本地缓存。使用插件的漏检诊断，查看接收状态和规则原因。该诊断不会获取全部历史消息，也不会触发处罚。

### [409、429 或未知动作状态](https://tgdog.wadesk.io/zh/guide/troubleshooting/#_409429-%E6%88%96%E6%9C%AA%E7%9F%A5%E5%8A%A8%E4%BD%9C%E7%8A%B6%E6%80%81)

409 表示更新接收冲突，请消除冲突后手动恢复。429 会遵循 Telegram 返回的重试延迟。未知动作需要查看执行记录，必要时核对成员状态，不应视为已完成。

[来源：机器人可以接收哪些消息？](https://core.telegram.org/bots/faq#what-messages-will-my-bot-get)

### [仍然需要帮助？](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E4%BB%8D%E7%84%B6%E9%9C%80%E8%A6%81%E5%B8%AE%E5%8A%A9)

[联系我们](https://tgdog.wadesk.io/zh/contact/)

## [核对你的配置](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E6%A0%B8%E5%AF%B9%E4%BD%A0%E7%9A%84%E9%85%8D%E7%BD%AE)

- 调整规则前，先检查消息接收与豁免。

- 409 表示接收冲突；429 需要等待。

- 清理本地数据前，先处理未知动作结果。

## [接下来读什么](https://tgdog.wadesk.io/zh/guide/troubleshooting/#%E6%8E%A5%E4%B8%8B%E6%9D%A5%E8%AF%BB%E4%BB%80%E4%B9%88)

如果是首次设置 TGDog，请按照[完整使用教程](https://tgdog.wadesk.io/zh/how-to-use/)操作。需要了解其他主题时，可以返回[指南文章库](https://tgdog.wadesk.io/zh/guide/)。

TGDogTGDog 产品文档。依据插件实际实现编写，并与 Telegram 官方资料核对。

[关于作者](https://tgdog.wadesk.io/zh/about/)

[← 上一篇消息证据、本地存储与保留期限](https://tgdog.wadesk.io/zh/guide/message-evidence/)
