模块化排查指南

# 1. JSON文件格式与内容问题

不规范的JSON格式是导致解析失败的最常见原因，Telegram对商业号API返回的JSON有严格格式要求。

  1. 1. 使用JSON验证工具检查文件有效性
  2. 2. 确保JSON使用UTF-8编码，无BOM头
  3. 3. 检查字段名称是否完全匹配API文档要求
  4. 4. 验证所有必填字段是否完整
提示：推荐使用Visual Studio Code等专业编辑器，它们会自动高亮JSON语法错误。

# 2. API请求频率与权限问题

商业号API有严格的请求频率限制，超出限制或权限不足会导致JSON解析失败。

  1. 1. 检查你的商业号API权限是否包含当前操作
  2. 2. 确保API密钥正确且未过期
  3. 3. 使用住宅代理IP轮换避免IP限制
  4. 4. 在代码中添加请求间隔(建议≥500ms)

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

不稳定的网络连接或错误的代理配置会导致JSON数据传输不完整。

  1. 1. 测试基础网络连接是否正常
  2. 2. 检查代理设置是否正确(如需)
  3. 3. 尝试关闭VPN或更换节点
  4. 4. 使用curl或Postman测试API连通性
提示：商业号操作推荐使用稳定的住宅代理服务，避免被封禁。

常见错误代码专项

错误："Invalid JSON format"

JSON格式不符合Telegram API规范。

  1. 1. 检查JSON开头结尾的大括号是否匹配
  2. 2. 确保所有字符串值都有双引号
  3. 3. 移除JSON中的注释(Telegram不支持)
  4. 4. 验证特殊字符是否转义

错误："API response timeout"

请求超时导致JSON数据接收不完整。

  1. 1. 增加API请求超时时间(建议≥10s)
  2. 2. 检查服务器响应时间是否过长
  3. 3. 优化网络连接质量
  4. 4. 考虑使用更稳定的代理服务