简而言之:Axios 在五个层级上设置头部信息,包括按请求配置、全局默认值、 axios.create() 实例、请求和响应拦截器,以及响应本身。本指南将通过可运行的 v1 代码片段逐层讲解,并修复四个让所有人都头疼的常见问题:多部分请求分界、CORS Cookie、自签名证书以及标头大小写问题。Axios 依然是大多数 JavaScript 和 TypeScript 团队首选的 HTTP 客户端,而用户报告的大部分“Axios 错误”其实根本不是 Axios 的问题,而是头部配置问题。一个配置参数的位置错误,就会悄无声息地导致你的 Authorization 。一个手动输入的 Content-Type: multipart/form-data 会导致每次上传都失败。一个全局 axios.defaults 令牌会泄露给您调用的每个第三方主机。一旦您了解该标头在请求生命周期中的正确位置,这些问题都有明确的解决方法。
这份 Axios 设置头部指南,正是我当初搭建首个拦截器栈时梦寐以求的指南。它针对 Node 20+ 上的 Axios v1,但其中的模式同样适用于浏览器环境(尽管存在差异)。 你将看到按请求设置的头部、全局默认值、作用域实例,以及请求和响应拦截器并列呈现,并附有选择它们的决策规则。你还将获得一个完整的 Axios 响应头部章节(大多数教程都会跳过),以及针对你在生产环境中实际遇到的错误的故障排除部分。




