模块化排查指南

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

网络波动会导致自动化任务与服务器通信中断，这是最常见的中断原因。

  1. 1. 检查你的Wi-Fi或移动数据是否正常开启
  2. 2. 尝试访问其他网站确认网络通畅性
  3. 3. 重启路由器或切换网络环境（4G/5G）
  4. 4. 临时关闭防火墙/杀毒软件测试
提示：使用ping api.telegram.org命令测试基础连接质量

2. API密钥失效或权限不足

过期的API密钥或错误配置会导致自动化服务被拒绝访问。

  1. 1. 登录开发者后台确认API密钥有效期
  2. 2. 检查机器人权限是否包含"发送消息"权限
  3. 3. 重新生成并替换脚本中的API密钥
  4. 4. 验证webhook配置地址是否正确
注意：密钥更新后需等待5-10分钟生效

3. 脚本运行环境异常

缺失依赖库或运行超时都会中断自动化流程。

  1. 1. 检查Python/Node.js等运行环境版本
  2. 2. 使用pip list确认依赖库完整
  3. 3. 增加脚本超时阈值（建议≥30秒）
  4. 4. 查看系统日志定位崩溃点

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

错误："Error 429: Too Many Requests"

请求频率超过平台限制导致的速率限制。

  1. 1. 立即停止当前任务1-2小时
  2. 2. 修改脚本加入随机延迟（0.5-2秒/次）
  3. 3. 申请提升API调用限额

错误："Error 502: Bad Gateway"

服务器端临时故障或代理配置错误。

  1. 1. 等待5分钟后重试
  2. 2. 检查代理服务器状态
  3. 3. 切换至住宅代理IP服务
推荐使用LIKE.TG住宅代理IP保证连接稳定性