模块化排查指南

# 1. 网络连接不稳定或受阻

不稳定的网络连接是推送失败的常见原因，可能导致请求无法到达Telegram服务器。

  1. 检查你的服务器网络连接状态，确保可以正常访问互联网
  2. 测试是否能够访问api.telegram.org或其他Telegram服务地址
  3. 临时关闭防火墙或VPN，排除网络限制因素
  4. 尝试切换网络环境（移动网络/WiFi）
提示：使用ping和traceroute命令可以帮助诊断网络连接问题。

# 2. 机器人权限不足或令牌失效

错误的bots权限或过期的访问令牌会直接导致推送请求被拒绝。

  1. 确保你使用的是正确的机器人令牌
  2. 通过@BotFather检查机器人是否有message发送权限
  3. 重新生成新的机器人令牌尝试
  4. 确认机器人未被用户封禁或限制
注意：令牌泄露可能导致安全问题，请妥善保管。

# 3. 超出API调用频率限制

Telegram对机器人API调用有严格的频率限制，超出将导致推送失败。

  1. 检查你的推送频率是否超过30条/秒(正常)/20条/秒(频道)
  2. 为大量消息添加1-2秒的延迟发送
  3. 对于大批量推送，考虑分批次处理
  4. 使用getUpdates方法监控返回的"retry_after"参数

# 4. 消息内容或格式不符合规范

某些特殊字符、格式或内容可能被Telegram过滤或拒绝。

  1. 检查消息长度是否超过4096字符限制
  2. 移除消息中的非法字符或特殊格式
  3. 避免包含被Telegram认定为垃圾信息的内容
  4. 分多次发送大块文本内容