模块化排查指南

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

不稳定的网络连接或错误的代理设置是导致队列阻塞的常见原因。

  1. 1. 检查你的网络连接是否稳定，尝试切换Wi-Fi/移动数据
  2. 2. 如果你使用代理/VPN，尝试关闭或更换节点
  3. 3. 测试其他网络环境是否能正常发送消息
提示：优先使用稳定的住宅代理IP，避免使用公共VPN节点。获取高质量住宅代理IP

# 2. API调用频率限制

Telegram对商业号API调用有严格频率限制，超出会导致队列阻塞。

  1. 1. 检查你的发送频率是否超过每分钟30条消息的限制
  2. 2. 如果是群发操作，确保间隔时间合理
  3. 3. 考虑使用消息队列管理系统控制发送节奏
提示：商业号运营需要专业工具支持，联系我们获取批量管理解决方案

# 3. 账号权限与安全设置

账号异常或安全设置变更可能导致发送功能受限。

  1. 1. 确认账号没有被限制或封禁
  2. 2. 检查两步验证是否正常
  3. 3. 确保API token仍然有效

# 4. 消息队列积压处理

大量积压的消息可能导致后续发送失败。

  1. 1. 暂停新的发送任务
  2. 2. 检查并清理积压的消息队列
  3. 3. 分批处理未发送的消息

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

错误："Flood Wait"

表示发送频率过高被限制。

  1. 1. 立即停止所有发送操作
  2. 2. 等待提示中显示的时间(通常几分钟到几小时)
  3. 3. 恢复后降低发送频率

错误："Peer Flood"

表示对特定用户/群组发送过于频繁。

  1. 1. 暂停对该用户/群组的发送
  2. 2. 延长发送间隔时间
  3. 3. 考虑使用多个账号轮换发送
提示：需要多账号管理？获取高质量Telegram协议号