axios发送POST请求设置header参数报417错误如何解决

后端服务正常的前提下，POST请求携带自定义header返回417 Expectation Failed错误，按以下顺序排查解决：

• 首先修正自定义header的值类型
  HTTP 协议规定header值必须为字符串类型，你当前代码里sales-channel、agency-code传的是数字类型，部分axios版本、网关代理、后端框架遇到非字符串类型的header值会出现解析异常，直接修改为字符串格式即可：

// PolicyService.js 对应headers配置修改为
headers: { 
  'sales-channel': '200008', 
  'agency-code': '10038', 
  'content-type': 'application/json' 
}

• 移除请求自动携带的Expect头
  axios在发送POST请求、请求体大小超过默认阈值时，会自动添加Expect: 100-continue请求头，要求服务端先确认是否接收请求体，如果后端服务、Nginx/API网关没有适配这个规则，就会直接返回417。可以直接在请求配置里清空Expect头，也可以给axios实例加全局默认配置：

// 单个请求配置里加
headers: { 
  'sales-channel': '200008', 
  'agency-code': '10038', 
  'content-type': 'application/json',
  'Expect': ''
}

// 或者全局配置，一次修改所有请求生效
axiosInstance.defaults.headers.common['Expect'] = '';

• 排查跨域预检（OPTIONS）请求异常
  你添加的sales-channel、agency-code属于自定义请求头，不属于CORS规范里的安全请求头范畴，浏览器会在正式POST请求前先发送OPTIONS方法的预检请求，确认服务端允许携带这两个头。如果后端没有正确处理OPTIONS请求（比如没放行OPTIONS方法、没配置允许这两个自定义头的跨域规则），部分网关层会直接返回417错误。
  打开浏览器F12的网络面板，筛选对应接口请求：

  • 如果先发出的OPTIONS请求就返回417，联系后端补全跨域配置：放行OPTIONS请求、在Access-Control-Allow-Headers里加上你传的两个自定义header
  • 如果OPTIONS请求返回200，再检查正式POST请求的请求头列表，确认自定义header是否真的被携带，有没有被中间代理层篡改

• 检查代理层配置
  如果本地开发用了vite/webpack dev proxy、线上请求经过Nginx/API网关转发，确认代理层没有拦截自定义header，也没有强制校验Expect头的规则，以Nginx为例，可以在转发配置里加上proxy_set_header Expect "";清空Expect头，避免代理层拦截返回417。

补充调试提示：你当前catch逻辑只打印了err对象，建议补上console.log(err.config, err.response)，可以直接看到实际发出的请求配置、服务端返回的完整响应头，能大幅缩短定位时间。

内容的提问来源于stack exchange，提问作者jron