一、问题场景
场景很简单,就是一个正常 axios post 请求:
axios({ headers: { ‘deviceCode‘: ‘A95ZEF1-47B5-AC90BF3‘ }, method: ‘post‘, url: ‘/api/lockServer/search‘, data: { username, pwd } })
后台说没有接收到你的传参。
这就有点奇怪了,我看了一下浏览器的请求信息是 OK 的,参数都是有的,而且之前这样用 axios 也没有这个问题。
但是这个接口是通用的,别人都用了,是 OK 的,接口没问题。
二、问题原因
1、要点一
后台接口方法上使用了注解@RequestParam
那么这个是什么意思呢,这个是只能从请求的地址中取出参数,也就是只能从 username=admin&password=admin
这种字符串中解析出参数。
2、要点二
我们还可以看到我们这次请求的 Content-Type:
application/json;charset=UTF-8
关于这一点需要说明的是:
1、axios会帮我们 转换请求数据和响应数据 以及 自动转换 JSON 数据
2、在axios源码中发现下面这段内容:(很关键)
我们知道在做 post 请求的时候,我们的传参是 data: {...}
或者直接 {...}
的形式传递的,嗯,就是下面这两种形式
【第一种形式】
【第二种形式】
非常的刺激,这两种形式无一例外都触发了 axios 源码中【很关键】的那一段代码
三、问题分析
也就是说,我们的 Content-Type
变成了 application/json;charset=utf-8
然后,因为我们的参数是 JSON 对象,axios 帮我们做了一个 stringify 的处理。
而且查阅 axios 文档可以知道:axios 使用 post 发送数据时,默认是直接把 json 放到请求体中提交到后端的。
那么,这就与我们服务端要求的 ‘Content-Type‘: ‘application/x-www-form-urlencoded‘
以及 @RequestParam
不符合。
四、解决方案
1、解决方案一
【用 URLSearchParams 传递参数】
let param = new URLSearchParams() param.append(‘username‘, ‘admin‘) param.append(‘pwd‘, ‘admin‘) axios({ method: ‘post‘, url: ‘/api/lockServer/search‘, data: param })
需要注意的是: URLSearchParams
不支持所有的浏览器,但是总体的支持情况还是 OK 的,所以优先推荐这种简单直接的解决方案
2、解决方案二
网上有很多方案说使用 axios.defaults.headers.post[‘Content-Type‘] = ‘application/x-www-form-urlencoded‘; 或者
{headers:{‘Content-Type‘:‘application/x-www-form-urlencoded‘}}
我试了一下,其实这样还是不行的
【还需要额外的操作,(我们需要将参数转换为query参数)】
引入qs,这个库是axios里面包含的,不需要再下载了。
import Qs from ‘qs‘ let data = { "username": "admin", "pwd": "admin" } axios({ headers: { ‘deviceCode‘: ‘A95ZEF1-47B5-AC90BF3‘ }, method: ‘post‘, url: ‘/api/lockServer/search‘, data: Qs.stringify(data) })
3、解决方案三
既然 axios 源码中有那么一段【很关键】的代码,那么,我们也可以通过修改 transformRequest
来达到我们的目的。
在 axios 的请求配置项中,是有 transformRequest
的配置的:
OK,那么现在我们的请求就可以写成下面这个样子了:
import Qs from ‘qs‘ axios({ url: ‘/api/lockServer/search‘, method: ‘post‘, transformRequest: [function (data) { // 对 data 进行任意转换处理 return Qs.stringify(data) }], headers: { ‘deviceCode‘: ‘A95ZEF1-47B5-AC90BF3‘ }, data: { username: ‘admin‘, pwd: ‘admin‘ } })
4、解决方案四
重写一个 axios 实例,重新实现属于我们自己的 transformRequest
import axios from ‘axios‘ let instance = axios.create({ transformRequest: [function transformRequest(data, headers) { normalizeHeaderName(headers, ‘Content-Type‘); if (utils.isFormData(data) || utils.isArrayBuffer(data) || utils.isBuffer(data) || utils.isStream(data) || utils.isFile(data) || utils.isBlob(data) ) { return data; } if (utils.isArrayBufferView(data)) { return data.buffer; } if (utils.isURLSearchParams(data)) { setContentTypeIfUnset(headers, ‘application/x-www-form-urlencoded;charset=utf-8‘); return data.toString(); } /*改了这里*/ if (utils.isObject(data)) { setContentTypeIfUnset(headers, ‘application/x-www-form-urlencoded;charset=utf-8‘); let _data = Object.keys(data) return encodeURI(_data.map(name => `${name}=${data[name]}`).join(‘&‘)); } return data; }], })
5、解决方案五
axios.post(‘/api/lockServer/search‘,"userName=‘admin‘&pwd=‘admin‘");
6、解决方案六(方案三借助拦截器实现)
import Qs from ‘qs‘
axios.interceptors.request.use(function(config){ //在发送请求之前做某事======》我们可以在这里处理啦
if(config.method == "post"){
config.data = Qs.stringify(config.data);
}
return config;
},function(error){
//请求错误时做些事 return Promise.reject(error); });
7、解决方案七
我们知道现在我们服务端接收参数用的是 @RequestParam
(通过字符串中解析出参数)
其实还有另一种是 @RequestBody
(从请求体中获取参数)。
我们让后端改成 @RequestBody
不就可以了吗