模块化排查指南

# 1. 网络连接与代理配置问题

不稳定的网络连接或错误的代理设置会导致监控任务无法正常执行。

  1. 1. 检查你的网络连接是否正常,尝试访问其他网站确认
  2. 2. 如果你使用代理,确保代理IP可用且未被Telegram封禁
  3. 3. 尝试切换不同的网络环境(WiFi/4G/5G)测试
提示:推荐使用稳定的住宅代理IP服务,避免使用数据中心IP可能被限制

# 2. API调用频率超限或被限制

Telegram对API调用有严格频率限制,超出限制会导致任务失败。

  1. 1. 检查你的API调用频率是否超过Telegram限制
  2. 2. 适当降低监控频率,建议间隔不低于30秒
  3. 3. 确保你的API密钥有效且未被封禁

# 3. 目标群组/频道访问权限问题

没有足够权限访问目标群组或频道会导致监控失败。

  1. 1. 确认你的账号已加入目标群组/频道
  2. 2. 检查群组是否设置为公开,私密群组需要特殊权限
  3. 3. 确保你的账号未被群组管理员封禁

常见错误代码专项

错误:"Flood Wait"

表示你的请求过于频繁,被Telegram暂时限制。

  1. 1. 立即停止所有请求,等待限制解除
  2. 2. 查看错误信息中的等待时间(如Flood Wait 3600表示需等待1小时)
  3. 3. 后续降低请求频率,增加间隔时间

错误:"Chat Not Found"

表示无法找到指定的群组或频道。

  1. 1. 确认群组/频道ID或用户名输入正确
  2. 2. 检查该群组是否已被删除或更名
  3. 3. 确认你的账号有权限访问该群组