我们通常使用application/x-www-form-urlencoded是因为这是HTML表单的默认编码类型,服务器端(尤其是Spring MVC)通常默认解析这种格式的数据。
如果我们不设置Content-Type,那么微信小程序默认的Content-Type是application/json,但是我们的后端接口接收的是application/x-www-form-urlencoded格式,所以会导致参数无法正确解析,从而请求失败。
在Spring MVC中,使用@RequestParam注解来获取参数时 ,默认情况下,它从请求的查询字符串或表单数据中读取参数,这要求请求的Content-Type为application/x-www-form-urlencoded或multipart/form-data。
如果使用application/json,则参数需要在请求体中,并且需要使用@RequestBody注解来接收。
因此,如果我们的后端接口是使用@RequestParam来接收参数,那么前端必须使用application/x-www-form-urlencoded格式来发送数据,即把参数编码成key=value&key2=value2的形式放在请求体中。
微信小程序的wx.request默认的Content-Type是application/json,它会将数据对象序列化成JSON字符串放在请求体中。这样,后端使用@RequestParam就无法获取到参数。
所以,我们需要显式设置Content-Type为application/x-www-form-urlencoded,并且将数据对象转换成这种格式的字符串。
但是,注意:微信小程序的wx.request方法,如果设置了Content-Type为application/x-www-form-urlencoded,那么它会自动将data对象转换成这种格式的字符串,所以我们只需要传入对象即可。
如果我们不设置,默认是application/json,那么就会发送JSON字符串,后端如果按照表单形式来解析,就会获取不到参数。
这就是为什么我们需要设置这个请求头。
但是,有时候后端接口也可能支持JSON格式,那么我们就可以不设置,使用默认的JSON格式。但根据你的接口代码,使用的是@RequestParam,所以必须使用表单格式。
另外,如果你的后端接口是使用@RequestBody来接收一个对象,那么就可以使用JSON格式,这时候就不需要设置这个请求头,或者设置为application/json。
总结:前后端的参数传递方式必须匹配,否则参数无法正确传递。
根据你的接口,参数是用@RequestParam接收的,所以前端必须使用表单格式(application/x-www-form-urlencoded)传递参数。
在微信小程序中,设置这个请求头后,它会自动将data对象转换成key=value&key2=value2的格式,并设置请求体为这个字符串,同时设置Content-Type为application/x-www-form-urlencoded。
如果不设置,那么默认就是JSON格式,后端就无法正确获取参数。
这就是为什么不加这个请求头可能会失败的原因。
注意:如果后端接口支持同时接收表单和JSON,那么可能不会失败。但根据你的代码,应该是只接收表单格式。
另外,有些后端框架可以自动处理,但Spring MVC默认不支持这种混合模式。
所以,为了确保请求成功,我们需要按照后端接口的要求设置请求头。