Spring后端无法接收移动端POST请求参数的适配问题

移动端的请求存在格式不匹配：

• 请求头Content-Type标记为application/json，但实际请求体（Request Payload）是表单编码格式（param1=toto&param2=titi）
• Spring的@RequestParam默认从URL查询参数或multipart/form-data的表单域中获取参数，不会解析放在请求体里的表单编码内容；而之前的Jersey框架@FormParam兼容这种场景，所以切换到Spring后出现异常。

由于移动端请求格式无法修改，后端可以通过以下几种方式适配：

方式一：用@RequestBody配合MultiValueMap接收参数 #

这是最直接的方案，Spring可以自动解析请求体中的表单编码内容到MultiValueMap，无需依赖正确的Content-Type：

import org.springframework.util.MultiValueMap;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestBody;

@PostMapping("/your-api-path")
public void yourMethod(@RequestBody MultiValueMap<String, String> requestParams) {
    String param1 = requestParams.getFirst("param1");
    String param2 = requestParams.getFirst("param2");
    // 执行业务逻辑
}

getFirst()方法用于获取单个参数值，如果参数有多个值可以用get()拿到列表。

方式二：配置消息转换器兼容错误的Content-Type #

如果你不想修改方法的参数定义，可以配置Spring的FormHttpMessageConverter，让它支持解析Content-Type: application/json的表单编码请求体，这样原来的@RequestParam就能正常工作：

import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.http.converter.FormHttpMessageConverter;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import java.util.List;

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        FormHttpMessageConverter formConverter = new FormHttpMessageConverter();
        // 让转换器同时支持application/json和标准的表单编码类型
        formConverter.setSupportedMediaTypes(List.of(
                MediaType.APPLICATION_JSON,
                MediaType.APPLICATION_FORM_URLENCODED
        ));
        converters.add(formConverter);
    }
}

配置后，Spring会自动将请求体中的表单编码内容解析为请求参数，@RequestParam就能正常获取到param1和param2。

方式三：手动读取并解析请求体 #

如果需要更灵活的控制，可以直接读取请求体内容，手动解析成参数：

import org.springframework.util.StreamUtils;
import org.springframework.web.bind.annotation.PostMapping;

import javax.servlet.http.HttpServletRequest;
import java.nio.charset.StandardCharsets;
import java.util.HashMap;
import java.util.Map;

@PostMapping("/your-api-path")
public void yourMethod(HttpServletRequest request) throws Exception {
    // 读取请求体内容
    String bodyContent = StreamUtils.copyToString(request.getInputStream(), StandardCharsets.UTF_8);
    // 解析表单编码格式的字符串为Map
    Map<String, String> paramMap = parseFormEncodedString(bodyContent);
    
    String param1 = paramMap.get("param1");
    String param2 = paramMap.get("param2");
    // 执行业务逻辑
}

private Map<String, String> parseFormEncodedString(String formContent) {
    Map<String, String> paramMap = new HashMap<>();
    String[] paramPairs = formContent.split("&");
    for (String pair : paramPairs) {
        String[] keyValue = pair.split("=");
        if (keyValue.length == 2) {
            paramMap.put(keyValue[0], keyValue[1]);
        }
    }
    return paramMap;
}

这种方法需要自己处理参数解析，适合有特殊格式需求的场景。

内容的提问来源于stack exchange，提问作者Lainea