HTTP 400 Bad Request — 服务端常见成因

诊断 HTTP 400：畸形 JSON、校验失败、Content-Type 不匹配与请求头问题，借助服务端日志与回显定位。

症状

API 返回 400 Bad Request。它常只在特定客户端出现，说明更可能是格式或契约不匹配，而非服务不可用。

查看服务端日志并用 curl 复现：

curl -v -X POST https://api.example.com/items \
  -H 'Content-Type: application/json' \
  -d '{"name": "widget"}'

在服务端记录校验错误，能把含糊的 400 变成可操作的字段级信息。

让负载符合契约、让内容类型符合正文：

{ "name": "widget", "quantity": 3 }

返回描述失败字段的结构化错误。

重新发送修正后的请求并成功，日志不再记录解析或校验错误，说明请求已符合 API 契约。