模块化排查指南

1. Token过期或已失效

Token通常有有效期限制，过期后将自动失效无法继续使用。

  1. 登录Telegram开发者后台检查Token状态
  2. 核对Token生成时间，一般有效期为1年
  3. 如已过期，重新生成新的Token替换
  4. 更新所有使用该Token的应用配置
提示：建议设置日历提醒在Token到期前1个月进行续期

2. 权限配置错误

若Token权限不足，将导致API调用被拒绝。

  1. 检查Token是否拥有生成时分配的完整权限
  2. 确认Token绑定的商业号账号状态正常
  3. 重新生成Token时勾选所需权限组
  4. 测试基础API接口调用是否正常

3. API调用频率过高

Telegram对API调用有严格频率限制，超限会导致Token临时禁用。

  1. 查看API调用日志统计请求频率
  2. 调整业务逻辑，增加请求间隔时间
  3. 实现请求队列和失败重试机制
  4. 如必须高频调用，考虑申请特殊权限
提示：普通Token的API调用限制为30次/秒，请合理规划调用频率