接口返回415:Content-Type和请求体怎么对应
适用范围:自己维护或被授权调用的HTTP接口;测试使用无副作用的测试端点。
415通常说明服务器不支持这次请求所声明或实际使用的内容格式。它与“服务器挂了”不是一回事。先看失败请求究竟发送了什么,不要只把Content-Type改成一个看起来正确的值。
保存一次失败请求的四项信息
在浏览器网络页或客户端调试日志中记录请求方法、目标路径、Content-Type和脱敏后的请求体。还要查看Content-Encoding:某些客户端压缩了正文,但服务端没有按对应编码解压。
接口约定是判断依据;POST并不自动等于JSON。Accept 表示期望接收的响应类型,Content-Type 描述这次发送的正文,两个不能互相代替。[1]
用测试端点分别验证三种格式
以下命令只用于自己的无副作用测试接口;不要对支付、开通、续费或发信接口重放。URL替换成真实测试地址。
JSON:
curl -i 'https://example.com/test-echo' \
-H 'Content-Type: application/json' \
--data-binary '{"message":"hello"}'
普通表单:
curl -i 'https://example.com/test-echo' \
--data-urlencode 'message=hello'
文件上传:
curl -i 'https://example.com/test-upload' \
-F 'file=@sample.txt'
后两种情况下让curl生成匹配的请求头。multipart上传还包含boundary,不要手工只写 multipart/form-data 却遗漏正文实际使用的边界。[2]
只改头部为什么仍不行
把 message=hello 标成application/json,内容仍不是JSON。反过来,将JSON字符串装进表单字段,接口可能收到的是一个名为payload的字符串,而不是期望对象。应在客户端选择匹配的序列化方式。
确认请求到达正确版本的接口;旧路由、新网关、错误的URL都可能有不同要求。如果同一请求本机直连正常而外部失败,检查代理是否改写了路径、请求头或正文,但不要为测试关闭鉴权。
415消失后还要验数据
400可能是语法不合法,其他4xx可能是字段校验或权限问题,不能把所有错误都当作格式问题。只有服务端按预期解析到测试字段,并得到业务约定的结果,才算这次修复有效。
提交排查资料时隐藏Authorization、Cookie、签名和个人数据。不要把“复制为curl”后的整段含凭据命令直接发给他人。
继续排查
浏览器跨域报错:CORS与预检请求排查;网站返回405,请求方法哪里不对。
技术依据:[1] RFC 9110:Content-Type、Content-Encoding与415;[2] curl:data-binary、data-urlencode、form。适用版本见本文说明。