> ## Documentation Index
> Fetch the complete documentation index at: https://docs.poixe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 非格式化错误

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

## 常见表现

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

## 典型例子：CDN 超时页面

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

## 处理建议

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