Axios 请求配置

Axios 单次请求可配置的字段及其默认行为、数据序列化和覆盖规则。

#type / concept #status / growing #tech / network #platform / browser #resource / http #resource / javascript #package / axios

[!info] related notes

Axios 请求配置

一句话定义

Axios 的 request config 是“这次 HTTP 调用的完整描述”,决定了 URL、方法、参数、请求体、超时、响应类型和成功判定。

核心内容

常见字段

  • url:请求路径,唯一必填项
  • method:HTTP 方法,默认 GET
  • baseURL:统一前缀
  • headers:请求头
  • params:查询字符串参数
  • data:请求体
  • timeout:超时
  • responseType:响应类型
  • validateStatus:成功状态码判定
  • signal:取消请求信号
  • transformRequest / transformResponse:请求和响应数据转换钩子

数据怎么进出

  • 普通对象通常会被转成 JSON
  • params 会进 URL 查询串
  • data 会进请求体
  • 表单、文件、流式场景要按内容类型单独处理

常见直觉

axios.get('/users', { params: { page: 1 } })
axios.post('/users', { name: 'Tom' })

边界与易混淆点

  • params 不是 data
  • timeout 和取消请求不是一回事
  • validateStatus 会改变哪些状态码进入 catch
  • 具体请求会覆盖实例默认值,但不会反过来
  • 自动数据转换通常发生在 transform 层,不是魔法

最短记忆方式

  • config 决定单次请求怎么发
  • params 管 URL,data 管 body
  • validateStatus 决定成功范围
创建于 2026/4/7 更新于 2026/4/9