模块化排查指南

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

不稳定的网络连接或错误的代理设置是导致自动化任务中断的首要原因。

  1. 1. 检查你的网络连接是否稳定，尝试ping telegram.org测试连通性
  2. 2. 确保代理IP可用，建议使用高质量住宅代理（推荐LIKE.TG住宅代理）
  3. 3. 清除本地DNS缓存（Windows: ipconfig/flushdns；Mac: sudo killall -HUP mDNSResponder）
提示：使用静态住宅代理IP比动态IP更稳定，可显著降低中断概率

2. 协议号配置参数错误

错误的API参数或过期token会导致TG协议号无法正常执行自动化任务。

  1. 1. 检查api_id和api_hash是否填写正确
  2. 2. 验证session文件是否有效（建议重新生成）
  3. 3. 确认设备信息配置与注册时一致

3. 自动化脚本兼容性问题

脚本与最新TG协议版本不兼容是常见的中断原因。

  1. 1. 更新你的telethon/pyrogram到最新版本
  2. 2. 检查脚本是否适配当前TG协议版本（当前最新为Layer 148）
  3. 3. 添加合理的请求间隔（建议每条消息间隔2-5秒）
注意：过度频繁的请求会触发TG风控机制，导致协议号被临时封禁

常见错误代码专项

错误：FLOOD_WAIT_X

表示操作过于频繁，被TG服务器限制。

  1. 1. 立即停止当前所有自动化任务
  2. 2. 等待指定时间（X秒）后再试
  3. 3. 调整脚本降低操作频率

错误：AUTH_KEY_DUPLICATED

协议号在多个设备同时登录导致冲突。

  1. 1. 终止所有现有会话
  2. 2. 重新生成session文件
  3. 3. 确保同一协议号不同时在多设备运行