适用范围与准备
适用于获准的API或订阅读取接口返回406 Not Acceptable,而浏览器或另一个客户端访问结果不同。先保留请求方法、脱敏请求头与错误正文;对照限于只读GET,不用真实上传或写接口试验。
先区分原因
406按HTTP规范表示服务器没有符合客户端主动协商条件的当前表示,并且不愿返回默认表示。Accept等字段表达希望接收的内容,Content-Type通常描述所发送的正文格式;两者用途不同。实际应用可能自定义错误,因此还应阅读接口文档,而非仅凭状态码断定唯一原因。
按顺序操作
- 确认响应确为HTTP 406,保存正文中的可用格式或错误说明。只看网页标题“无法访问”不足以区分网络失败和内容协商拒绝。
- 比较成功与失败客户端的Accept以及相关协商头,并保持目标、账号、方法与路径一致。先查自己添加的过窄格式限制,不同时切换节点和全部请求头。
- 按接口文档选择它实际支持的响应媒体类型。若文档要求JSON,明确请求JSON;不要为了得到200就接受任意格式后仍强行交给原解析器。
- 在脚本副本中只调整已确认有问题的协商字段,做一次获准GET。Content-Type不是通用的响应选择开关,没有请求正文时也不应靠随意补它解决406。
- 检查返回Content-Type、正文结构和解析结果。若服务器仍返回406,保留请求与响应对照交给维护者,确认是否存在网关自定义策略或未支持的格式。
| 字段或状态 | 用途 |
|---|---|
| Accept | 表达可接受的响应媒体类型 |
| Content-Type | 标识消息正文的媒体类型 |
| 406 | 按规范核对响应内容协商 |
| 200但正文格式变化 | 仍须重新检查解析和业务内容 |
怎样确认有效
正确结果是服务器提供了接口支持且客户端能处理的内容;拿到HTML错误页却不再报406,不算修复。保留原始失败样本,不能删除后宣称所有客户端一致。
无效时恢复与下一步
恢复原请求副本,避免将过宽Accept永久扩散到其他接口。本文只核对HTTP语义及隔离夹具,不验证真实账号、订阅或厂商自定义错误码。