接口只接受JSON,客户端却收到415。有人先把Accept改成 application/json,再次请求仍然失败。问题常出在看错了方向:Accept描述希望收到什么,Content-Type描述这条消息实际装了什么。

2026年11月17日,本文用蜘蛛模拟抓取观察固定415状态,再通过本机受控接口比较两种请求头。所有正文均为公开演示文本,没有登录信息,也没有修改线上服务。

先看工具这次实际发了什么请求

公开地址 https://httpbingo.org/status/415 按路径返回415。本次工具详情记录了该数字状态,证明它收到了相应HTTP响应;它没有向JSON接口提交正文,因此不能据此推断某个真实API的数据格式有问题。

公开固定状态样例的当前抓取详情;本次是普通GET,不是向业务接口提交JSON的测试
公开固定状态样例的当前抓取详情;本次是普通GET,不是向业务接口提交JSON的测试

415表示服务端不支持这次请求内容的格式;判断可能涉及媒体类型、内容编码或对内容的检查。不能把所有415都归因为“网络不通”,也不能只改响应偏好而不检查实际提交格式。

读取错误正文通常比反复切换Accept更有用。有些服务会给出期望类型或字段,网关也可能在请求到达应用之前拒绝它。应保存完整的状态、Content-Type、Content-Encoding与错误正文,确定响应由哪一层生成。

同样的Accept,为什么一组失败、一组成功

本地演示接口约定只接受 application/json。第一组发送同一段JSON外观的文字,但声明为 text/plain,同时用Accept要求JSON响应。结果仍是415,正文说明期望JSON类型。

本地受控请求把正文声明成text/plain;Accept虽为application/json,仍按演示约定返回415
本地受控请求把正文声明成text/plain;Accept虽为application/json,仍按演示约定返回415

第二组只把请求Content-Type改为 application/json,Accept与正文保持相同。本次返回200,并回显服务接受的请求类型。这说明在本例的明确约定下,影响结果的是请求内容类型,而非Accept。

同一本地接口改为application/json后返回200;这只是演示接口的媒体类型检查通过
同一本地接口改为application/json后返回200;这只是演示接口的媒体类型检查通过

注意,第二组不能证明这段JSON已经通过所有业务校验。演示服务只检查类型字段;真实API还可能检查JSON语法、必填字段、字段值与权限。改对类型之后出现400或422,应继续按新的错误处理,不能为了得到200再随意删除校验条件。

复现时把正文与头一起保存

可将下面代码保存为 server.py 后执行 python3 server.py。它只监听本机8765,测试结束按Ctrl+C停止。

from http.server import BaseHTTPRequestHandler, HTTPServer
class Demo(BaseHTTPRequestHandler):
    def do_POST(self):
        n = int(self.headers.get('Content-Length', '0'))
        self.rfile.read(n)
        media = self.headers.get('Content-Type', '').split(';')[0]
        ok = media == 'application/json'
        body = b'{"accepted_content_type":"application/json"}' if ok else b'{"error":"expected_application_json"}'
        self.send_response(200 if ok else 415)
        self.send_header('Content-Type', 'application/json')
        self.send_header('Content-Length', str(len(body)))
        self.end_headers(); self.wfile.write(body)
HTTPServer(('127.0.0.1', 8765), Demo).serve_forever()

先发错误类型,再对照正确类型。自动实验使用随机空闲端口,以下固定8765便于手动运行:

curl -i -H 'Accept: application/json' \
  -H 'Content-Type: text/plain' --data '{"hello":"world"}' \
  'http://127.0.0.1:8765/media'
curl -i -H 'Accept: application/json' \
  -H 'Content-Type: application/json' --data '{"hello":"world"}' \
  'http://127.0.0.1:8765/media'

不要只保留格式化后的JSON。排查签名、编码或压缩问题时,真正发送的字节与头部同样重要;声明成JSON不会自动把表单正文转换成JSON,声明了gzip也不会替客户端压缩原始文本。

回到自己的API,先按接口约定组织请求

确认它接收JSON、表单还是文件上传。使用multipart上传时,还要让客户端正确生成分隔边界,不能只手写一个不完整的Content-Type。响应的Content-Type则属于另一条消息,不要拿它覆盖请求端设置。

如果服务期望压缩请求,还要核对Content-Encoding与真实编码是否对应。本文没有发送压缩正文,不能用两组媒体类型结果排除真实系统的解压失败。

用网站测速补查访问链路时,也要保持请求方法、正文与关键头一致。GET样例返回415、POST格式检查通过和业务处理完成,分别需要不同证据,写工单时分开记录即可。