代理返回 406 怎么排查:内容协商、Accept 请求头、语言和压缩格式

客户端通过代理网关比较响应格式并定位内容协商不兼容的排查示意图

代理访问返回 406,通常表示目标资源存在,但服务端无法提供符合客户端内容协商条件的响应表示,并且不愿返回默认格式。它不等于代理连接失败,也不应先通过更换出口处理。正确顺序是保存原始请求与响应,定位 406 由哪一层生成,再逐项核对 Accept、Accept-Language、Accept-Encoding、缓存和网关改写。

开始前记录请求时间、完整 URL、方法、状态码、响应体摘要、请求标识、代理入口与出口、客户端版本,以及三个协商请求头的原始值。认证信息只记录类型和脱敏摘要。若请求会写入数据,先在获准的测试环境中复现,不要为了试出可用格式而连续提交业务请求。

先确认这确实是 406

406 关注的是“客户端声明可接受什么响应,而服务端能提供什么响应”。如果请求体格式不被服务端接受,通常更接近 415;如果方法不适用于资源,则应按方法、允许方法和路由检查处理;如果 URL 被改写到不存在的资源,则先走 404 路径。

  • 通过条件:原始状态码为 406,且已保存协商请求头、响应体和返回层。
  • 失败条件:客户端把 400、404、405、415 或网关错误统一显示成“不接受”。
  • 停止条件:无法取得原始报文,或继续复测会产生写入、订单、发布等副作用。

第一步:定位 406 由哪一层返回

对齐客户端、代理入口、出口、边缘节点和目标应用的时间线。通过出口、状态码和请求阶段日志字段确认请求是否已通过代理,以及哪个节点最先返回 406。错误页样式、Server、Via、请求标识和响应时间只能作为线索,最终仍要以逐跳记录为准。

观察结果更可能的问题层下一步
直连和代理都返回 406目标应用的内容协商规则比较可用响应格式
直连成功,代理路径返回 406请求头改写、缓存或网关策略逐跳比较协商请求头
只有特定客户端返回 406客户端默认 Accept 组合导出实际请求头
只有特定语言返回 406语言表示或回退规则检查 Accept-Language
刷新后结果变化缓存键或边缘节点不一致检查 Vary 与缓存命中

第二步:保存实际发出的协商请求头

不要只看代码配置,要保存客户端最终发出的 Accept、Accept-Language 和 Accept-Encoding。浏览器、接口库、自动化工具和中间件可能添加默认值,也可能合并重复字段。若请求头语法、分隔符或编码本身异常,先转入请求行、请求头与编码检查。

第三步:核对 Accept 与响应 Content-Type

Accept 表示客户端能理解的媒体类型。将其与目标资源实际支持的 Content-Type 列表比较,重点检查具体媒体类型、通配符和质量权重。质量值为零表示明确不可接受;过度收窄到单一格式,也可能让本来可用的默认响应被排除。

第四步:核对 Accept-Language 与语言回退

记录语言标签、地区子标签、质量权重和通配符,并确认服务端是否有默认语言。不要把页面上的语言选择器与请求头混为一谈:用户明确选择的语言、URL 中的地区路径和请求头可能进入不同的路由或回退逻辑。若路径本身发生变化,按URL、重定向、地区版本和 Host 路径单独核对。

第五步:核对 Accept-Encoding 与压缩支持

确认客户端声明支持的压缩编码与服务端可用编码是否有交集,并检查是否把未压缩表示明确排除。代理或网关可能解压、重新压缩或删除相关字段;应比较进入代理前、离开代理后和目标侧看到的原始值。不要把连接层压缩、传输内容编码和文件格式混成一类。

第六步:检查质量权重和通配符

质量权重决定偏好顺序,零值表示不可接受。测试时按“原始值、放宽一个维度、恢复原始值”的顺序做最小对照,不要一次删除全部协商请求头,否则只能证明宽松请求能成功,无法定位是媒体类型、语言还是压缩导致冲突。

第七步:逐跳检查代理和网关改写

比较客户端发送前、代理入口、出口和目标应用收到的协商请求头,确认是否被删除、合并、截断或增加默认值。若多个网关参与,给每一跳保留请求标识。上游不可用或网关无法取得目标响应时,应转入网关、上游节点和目标站检查,不要继续按 406 处理。

第八步:检查缓存键和 Vary

同一 URL 可能按语言、媒体类型或压缩编码缓存多个响应版本。保存 Vary、Age、缓存命中标识、边缘节点和响应的 Content-Type、Content-Language、Content-Encoding。若缓存没有按必要字段区分表示,可能把一个客户端的响应错误复用于另一个客户端。

第九步:用最小对照实验定位冲突字段

保持 URL、方法、认证、代理出口和请求体不变,每次只放宽一个协商维度,并保存结果。先测试媒体类型,再测试语言,最后测试压缩;每次完成后恢复原始值。对照实验应使用获准的只读请求或测试资源,避免把业务状态变化误判为请求头修复。

检查层必须记录通过条件失败后的动作
响应来源时间、请求标识、入口与出口日志能定位生成 406 的节点补齐逐跳记录
媒体类型Accept、可用 Content-Type、质量权重至少有一个非零匹配修正客户端偏好或服务端表示
语言Accept-Language、URL 地区、回退规则存在可用语言或默认语言修正正式语言路径或回退配置
压缩Accept-Encoding、Content-Encoding、逐跳变化双方存在可用编码恢复兼容编码或未压缩表示
缓存Vary、Age、命中标识、边缘节点缓存按必要协商字段区分按正式机制修正缓存键
对照实验单变量修改、结果、恢复动作能复现并隔离一个冲突字段停止扩散变量并转交负责人

如何区分 406 与 415

406 通常讨论服务端返回给客户端的响应表示;415 通常讨论客户端发送给服务端的请求内容格式或内容编码。排查时同时保存请求的 Content-Type 与响应的协商字段,但不要因为状态码相近就互换修复动作。

什么时候可以重试

只有确认一个明确修正项后才进行少量受控复测,例如恢复了兼容的媒体类型、修正了语言回退、恢复了可用压缩编码,或纠正了网关的请求头改写。406 通常不是临时网络错误,不应直接套用自动重试。需要统一次数和终止阈值时,可参考临时故障的重试与停止边界。

  • 通过条件:同一正式请求在直连和代理路径都得到客户端可处理的响应表示。
  • 失败条件:某一层持续改写协商请求头,或缓存返回与请求偏好不匹配的表示。
  • 停止条件:共享网关或缓存需要变更、测试请求存在副作用、可用表示不明确,或无法保存逐跳证据。

团队交接要记录什么

交接记录至少包括完整 URL、方法、首次异常时间、代理入口与出口、返回 406 的层、三个协商请求头原值、服务端可用表示、响应内容类型与语言、内容编码、质量权重、重定向链、Vary 与缓存标识、单变量对照结果、修正项、复测结果、负责人和下次复核时间。

最终判断

代理返回 406 的核心不是更换 IP,而是确认客户端声明的响应偏好与服务端可提供的表示是否存在交集。先定位返回层,再检查媒体类型、语言、压缩、质量权重、逐跳改写和缓存键。只要共享配置需要变更、测试存在副作用或无法隔离冲突字段,就应停止自动复测并转交应用或网关负责人。

类似文章