模块化排查指南

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

不稳定的网络是导致定时任务失败的首要原因，特别是在安哥拉部分地区网络波动较大时。

  1. 检查你的Wi-Fi或移动数据信号强度，确保网络畅通
  2. 尝试切换网络环境（比如从Wi-Fi切到4G/5G）
  3. 运行ping测试到Zalo服务器（ping api.zalo.me）
提示：安哥拉部分地区网络不稳定，建议使用稳定代理服务如LIKE.TG住宅代理

2. Zalo账户授权异常

定时任务需要持续有效的账户授权，令牌失效会导致任务中断。

  1. 登录Zalo开发者平台检查access token是否过期
  2. 重新获取OAuth授权（有效期通常为60天）
  3. 确认应用权限包含定时任务所需的所有API权限

3. 定时任务参数配置错误

不正确的定时设置或参数会导致任务无法正常执行。

  1. 复查任务的时间表达式（cron表达式）是否正确
  2. 检查任务指向的API接口/回调地址是否有效
  3. 验证请求参数格式和内容是否符合API文档要求
注意：时区设置是常见错误源，安哥拉使用UTC+1时区

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

错误： "Invalid Access Token"

访问令牌失效或无效。

  1. 通过OAuth流程获取新的access token
  2. 更新定时任务配置中的token信息
  3. 检查token是否关联了正确的应用ID

错误： "API Limit Exceeded"

触发了Zalo API的调用频率限制。

  1. 查看当前API配额和使用情况
  2. 适当降低任务执行频率或申请提高配额
  3. 考虑错峰执行多个定时任务