模块化排查指南

1. 网络连接与代理问题

不稳定的网络或错误的代理设置会导致API请求失败。

  1. 检查你的网络连接状态，尝试访问其他网站确认网络正常
  2. 如果你使用代理/IP服务，确保代理设置正确且未被禁用
  3. 尝试切换网络环境（如从WiFi切到移动数据）
提示：LIKE.TG的住宅代理IP服务提供稳定连接方案，点击了解详情

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

过期/无效的API密钥或权限不足会直接导致调用异常。

  1. 确保你的API密钥正确且未过期（检查有效期）
  2. 核对密钥是否具有自动回复功能的调用权限
  3. 如使用Bot Token，确认机器人已加入目标对话

3. 请求参数与格式错误

错误的参数格式或遗漏必填字段会导致API拒绝请求。

  1. 检查API文档，确认所有必填参数（如chat_id、text等）
  2. 验证参数类型是否正确（如数字/字符串/布尔值）
  3. 特别注意JSON格式是否符合规范（引号、括号匹配）

常见错误代码及针对性解决方案

错误：401 Unauthorized

身份验证失败，API密钥无效或被撤销。

  1. 重新生成API密钥并替换现有配置
  2. 检查密钥是否包含拼写错误
  3. 如使用Bot，确认机器人没有被封禁

错误：429 Too Many Requests

触发了API调用频率限制。

  1. 立即暂停请求，等待1-2分钟后重试
  2. 优化代码逻辑，添加请求间隔延迟（建议≥300ms）
  3. 如需高频调用，考虑申请权限提升配额

错误：400 Bad Request

请求参数格式错误或缺失必填字段。

  1. 仔细检查请求体是否符合API文档要求
  2. 使用JSON验证工具检查格式有效性
  3. 特别关注嵌套参数的结构正确性