跳转到主要内容
非格式化错误通常发生在「客户端 ↔ 系统」的通信链路上。它的特点是:响应体可能不是 JSON,而是纯文本或 HTML 页面。

常见表现

  • HTML 错误页(例如网关/代理/CDN 的错误页面)
  • 请求超时导致的页面返回
  • 网络中断、连接被重置等(客户端直接报错,无响应体)

典型例子:CDN 超时页面

当请求经过 CDN 并触发强制超时(例如 120 秒),客户端可能收到一个 HTML 页面,而不是标准 JSON。

处理建议

  • 客户端应同时处理:
    • JSON 错误(可解析)
    • 非 JSON 响应(按文本记录并上报)
  • 若需要排查:尽量记录响应头(如能拿到 Poixe-Request-Id),并保留原始响应内容片段