2026-04-24 · 约 1 分钟阅读
HTTP 响应排障清单
用状态码、Header 与载荷结构，快速定位 API 失败原因。
HTTPAPI排障
要点
- 先看状态码与 Content-Type，再深入响应体细节。
- 复现时保持 Header 与 Query 一致，避免误判。
快速分诊流程
先从状态码与响应头入手，可快速区分鉴权问题、参数问题与上游故障。
遇到 4xx 时，先对照 API 文档核对请求头与请求体结构再重试。
遇到 5xx 时，保留 request id 与时间戳，便于后端日志关联定位。
保证可复现
记录完整 URL、query、鉴权模式与请求体，形成最小可复现样例。
若请求包含动态字段（时间戳、nonce），尽量固定测试样本降低噪声。
常见问题
为什么加了 token 仍然 401？
先确认 Authorization 格式是否符合上游要求（Bearer、Basic 或 Cookie 会话）。
415/422 通常怎么定位？
优先核对 Content-Type 与请求体 schema，并先在本地验证 JSON 合法性。