模块化排查指南

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

不稳定的网络或错误的代理设置会导致API请求无法正常发送到Zalo服务器。

  1. 1. 检查你的网络连接是否正常，尝试访问其他网站确认
  2. 2. 如果你使用代理，确保代理设置正确且未被Zalo屏蔽
  3. 3. 尝试关闭VPN或切换网络环境（WiFi/移动数据）
提示：优先使用稳定的住宅代理IP，避免使用数据中心IP可能被Zalo限制。获取优质住宅代理IP

2. API密钥与权限验证失败

无效或过期的API密钥，或缺少必要权限都会导致调用异常。

  1. 1. 登录Zalo开发者平台检查API密钥是否有效
  2. 2. 确认你的应用已获得解封API的调用权限
  3. 3. 重新生成API密钥并更新到你的代码中
注意：API密钥需妥善保管，泄露可能导致账号安全问题

3. 请求频率超限或被临时封禁

Zalo对API调用有严格的频率限制，短时间内大量请求会触发保护机制。

  1. 1. 检查你的调用频率是否超过Zalo规定的上限
  2. 2. 如果是批量操作，添加适当的请求间隔（建议≥1秒）
  3. 3. 等待1-2小时让系统自动解封后再试

常见错误代码及解决方案

错误：401 Unauthorized

身份验证失败，API密钥无效或缺失。

  1. 1. 检查请求头中的Authorization字段是否正确
  2. 2. 确认使用的是最新有效的API密钥
  3. 3. 确保密钥格式正确（Bearer token格式）

错误：403 Forbidden

权限不足或被封禁。

  1. 1. 确认你的账号有调用解封API的权限
  2. 2. 检查是否因违规操作被临时封禁
  3. 3. 联系Zalo客服申诉解封

错误：429 Too Many Requests

请求频率过高被限流。

  1. 1. 立即停止当前所有API调用
  2. 2. 等待1小时后降低频率重试
  3. 3. 实现指数退避算法优化请求频率