模块化排查指南

# 1. 网络连接不稳定或中断

不稳定的网络连接是导致tg数据自动轮询失败的最常见原因，特别是在使用代理或VPN时。

  1. 1. 检查你的Wi-Fi或移动数据是否正常开启，尝试切换网络环境
  2. 2. 如果你使用代理/VPN，尝试关闭后重新连接或更换节点
  3. 3. 在命令行执行ping api.telegram.org测试基础连通性
提示：优先使用有线网络连接，移动网络建议切换4G/5G信号较强的环境

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

Telegram对机器人API有严格的调用频率限制，超频会导致自动轮询失败。

  1. 1. 检查你的轮询间隔是否小于30秒（官方最低限制）
  2. 2. 在代码中添加延迟处理，建议设置35-40秒间隔
  3. 3. 使用getUpdates方法的timeout参数优化请求
注意：新账号/机器人初始阶段限制更严格，建议逐步增加调用频率

# 3. 代理服务器配置错误

错误的代理设置会导致API请求无法到达Telegram服务器。

  1. 1. 确认你的代理IP未被Telegram封禁（测试直接访问web.telegram.org）
  2. 2. 检查代理端口和认证信息是否正确配置
  3. 3. 尝试更换高质量住宅代理IP（推荐LIKE.TG住宅代理）

常见错误提示及针对性解决方案

错误： "429 Too Many Requests"

表示你的请求频率超过了Telegram API限制。

  1. 1. 立即停止所有请求至少30分钟
  2. 2. 修改代码将请求间隔增加到60秒以上
  3. 3. 考虑使用webhook替代轮询机制

错误： "Unauthorized"

通常表示你的bot token已失效或配置错误。

  1. 1. 重新获取bot token并更新到代码中
  2. 2. 检查是否有泄露风险，必要时撤销旧token
  3. 3. 确认你的机器人未被用户手动停止