模块化排查指南

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

API调用需要稳定的网络连接，网络问题是最常见的失效原因。

  1. 1. 检查你的Wi-Fi或移动数据是否正常开启
  2. 2. 尝试访问其他网站或服务测试网络连通性
  3. 3. 重启路由器或切换网络环境（如从Wi-Fi换到移动数据）
  4. 4. 使用ping命令测试Zalo服务器连通性
提示：优先使用有线网络连接，稳定性最佳

2. API密钥过期或无效

API密钥是访问Zalo服务的凭证，过期或错误配置会导致失效。

  1. 1. 登录Zalo开发者平台检查API密钥状态
  2. 2. 确认密钥未过期且处于激活状态
  3. 3. 核对代码中的密钥是否与平台一致
  4. 4. 如有必要，重新生成并替换API密钥
注意：密钥泄露会带来安全风险，请妥善保管

3. Zalo服务器维护或故障

Zalo官方服务器可能出现临时维护或故障。

  1. 1. 访问Zalo官方状态页面查看服务状态
  2. 2. 关注Zalo官方社交媒体获取最新公告
  3. 3. 等待官方修复完成后再尝试

4. 调用频率超出限制

Zalo API有调用频率限制，超出会导致临时封禁。

  1. 1. 检查你的API调用频率是否超出限制
  2. 2. 实现请求队列或延迟机制降低调用频率
  3. 3. 联系Zalo申请提高API调用限额

常见错误代码及解决方案

错误： "Invalid API Key"

API密钥无效或已过期

  1. 1. 重新生成API密钥
  2. 2. 更新代码中的密钥配置
  3. 3. 等待5-10分钟让新密钥生效

错误： "Rate Limit Exceeded"

API调用频率超出限制

  1. 1. 立即停止API调用
  2. 2. 等待1小时冷却期
  3. 3. 优化代码降低调用频率

错误： "Permission Denied"

账户权限不足

  1. 1. 检查账户是否具有客服系统API访问权限
  2. 2. 联系管理员申请相应权限
  3. 3. 确认OAuth授权范围包含所需权限