You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Axios 1.x版本如何正确配置自定义paramsSerializer?

Axios 1.x 自定义参数序列化器配置方法

Axios 1.x版本对paramsSerializer的配置逻辑做了调整,既支持新的对象格式配置,也兼容旧的函数格式配置。如果要沿用之前基于qs的序列化规则(数组用逗号分隔、不编码),可以按以下两种方式配置:

方式一:对象格式配置(推荐)

在paramsSerializer对象中,通过serialize属性传入自定义序列化函数,同时可搭配全局编码配置:

axios.defaults.paramsSerializer = {
  encode: false,
  serialize: (params) => qs.stringify(params, { arrayFormat: 'comma', encode: false })
};

方式二:保留原函数格式配置

Axios 1.x并未移除函数式配置,你可以直接沿用之前的写法:

axios.defaults.paramsSerializer = params => qs.stringify(params, { arrayFormat: 'comma', encode: false });

补充说明

  • 对象格式中的encode是全局默认编码规则,但如果自定义序列化函数(比如qs.stringify)内部指定了encode参数,会优先使用函数内的配置。
  • 除了全局配置,也可以在单个请求中单独设置paramsSerializer,用法和全局配置完全一致。

内容的提问来源于stack exchange,提问作者Alex

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.17 05:50:34