中转站返回400 Bad Request,排障先分清是哪一层拒绝:网关层拦截还是业务层拒绝。中转站通常指统一入口或API网关,它收到请求后会先检查请求头、请求体格式、路由权限,再转发给后端。后端业务日志里没有对应请求记录时,大概率在网关层已经被拦下。请求体JSON序列化出错,或Content-Type与请求体不匹配,是这一层最常见的两个原因。
先确认报错信息指向哪一层
拿到400响应时,先看响应体正文。多数网关会返回一段错误说明,可能是JSON格式的error字段,也可能是纯文本。错误内容里如果出现media type、content type、unsupported等词,说明是头信息未被接受;出现parse error、unexpected character、invalid token等词,说明是请求体解析失败。响应体为空或只有通用错误码时,去查网关访问日志,看请求在实际路由前是否已被拦截。日志排查范围需要结合你所用网关的类型确认,不依赖特定厂商文档。
Content-Type与请求体格式必须一致
Content-Type告诉网关用哪种方式解析请求体。发起方如果发送的是JSON文本,Content-Type应当是application/json;发送表单格式数据,才用application/x-www-form-urlencoded。常见错误是代码里手动拼接JSON字符串,却没有设置请求头,默认被HTTP客户端库写成application/x-www-form-urlencoded或text/plain。网关按错误方式解析,要么直接返回400,要么解析出一堆空字段。另有一种情况是Content-Type写成了application/json;charset=UTF-8,多数服务端能处理,某些实现会比较严格,只认application/json,是否需要调整取决于网关解析逻辑。
JSON序列化问题:先验证请求体本身是否合法
JSON序列化问题不仅指代码抛异常。请求体写出来是一段畸形JSON,在网关层就会被拒绝。比如字符串中未转义的引号、对象末尾多出的逗号、花括号不配对、控制字符未转义等。要判断请求体本身是否合法,最直接的做法是用命令行工具解析原始请求体。保存请求体到request_body.json文件后执行:
jq . request_body.json解析成功会重新格式化输出;解析失败jq会提示出错位置。如果没有jq,也可以用python3 -m json.tool request_body.json。注意这两个命令只验证JSON格式,不会验证字段是否符合后端数据结构,字段缺失或类型不符是业务层的另一类问题,不会在网关层触发400。
用最小请求区分两类问题
用curl直接模拟一次请求,可以快速定位问题在哪一侧。执行位置在发起方机器,建议先从最简请求开始:
curl -i -X POST '你的请求地址' -H 'Content-Type: application/json' -d '{"key":"value"}'-i参数用于输出响应头,方便确认Content-Type是否被回显,以及状态码来源是否来自网关。如果最简请求成功,问题在客户端构造请求体过程中,需要检查框架或SDK对请求体的处理。如果最简请求也返回400,并且地址和鉴权方式没问题,说明网关对请求格式校验有额外要求,建议看响应体错误信息逐项排查。
排查顺序和风险提示
建议先修Content-Type,再查JSON序列化。Content-Type的错误在代码里通常是一行明确的设置操作,排查范围小;序列化问题则需要结合框架和调用链确认,花费时间更长。调整Content-Type时要注意,不要盲目改成application/json——如果实际请求体是表单格式,改了反而会让网关用JSON解析器处理错误格式。另外,不要在网关侧开启宽松解析来掩盖问题。宽松模式会放行不合法JSON,把错误带进后端业务逻辑,后续数据落库时更难追踪。客户端侧的修复才是更稳妥的方向。
常见问题
网关返回400但响应体为空,应该怎么办?先看网关访问日志里的请求头、请求体大小和路由信息,确认请求是否到达路由层。部分网关对超长Header或畸形Host也会直接返回400,这类问题与JSON和Content-Type无关。日志里通常会记录拦截原因。