SpringBoot @RequestBody 报错（'application/x-www-form-urlencoded;charset=UTF-8' not supported）

最新推荐文章于 2025-08-13 13:55:14 发布

原创最新推荐文章于 2025-08-13 13:55:14 发布 · 3w 阅读

12 ·

CC 4.0 BY-SA版权

Java技术同时被 2 个专栏收录

19 篇文章

订阅专栏

Spring

7 篇文章

订阅专栏

本文详细解析了在SpringBoot中使用@RequestBody时出现的Contenttype'application/x-www-form-urlencoded;charset=UTF-8'notsupported错误，并提供了解决方案。通过自定义RequestMappingHandlerAdapter并添加JSON处理转换器，成功消除了报错。

在Spring boot 中使用 @RequestBody 会报错，提示错误 Content type 'application/x-www-form-urlencoded;charset=UTF-8' not supported，代码如下：

    @RequestMapping(value = "/act/service/model/{modelId}/save", method = RequestMethod.POST)
	public void saveModel(@PathVariable String modelId, @RequestBody MultiValueMap<String, String> values) {
        // 具体代码
	}

这个在传统 spring MVC 中是有效的，但是在 Spring boot 中会报错。
传统是 Spring MVC 有效，是因为有 <mvc:annotation-driven> 注解，查资料，<mvc:annotation-driven> 注解配置了如下的内容
spring 3.1 版本：

<!-- 注解请求映射  -->
    <bean class="org.springframework.web.servlet.mvc.annotation.DefaultAnnotationHandlerMapping">        
        <property name="interceptors">
            <list>  
                <ref bean="logNDCInteceptor"/>   <!-- 日志拦截器，这是你自定义的拦截器 -->
            </list>        
        </property>        
    </bean>      
    <bean class="org.springframework.web.servlet.mvc.annotation.AnnotationMethodHandlerAdapter">
        <property name="messageConverters">  
            <list>  
                <ref bean="byteArray_hmc" />  
                <ref bean="string_hmc" />  
                <ref bean="resource_hmc" />  
                <ref bean="source_hmc" />  
                <ref bean="xmlAwareForm_hmc" />  
                <ref bean="jaxb2RootElement_hmc" />  
                <ref bean="jackson_hmc" />  
            </list>  
        </property>  
    </bean>  
    <bean id="byteArray_hmc" class="org.springframework.http.converter.ByteArrayHttpMessageConverter" /><!-- 处理.. -->
    <bean id="string_hmc" class="org.springframework.http.converter.StringHttpMessageConverter" /><!-- 处理.. -->
    <bean id="resource_hmc" class="org.springframework.http.converter.ResourceHttpMessageConverter" /><!-- 处理.. -->
    <bean id="source_hmc" class="org.springframework.http.converter.xml.SourceHttpMessageConverter" /><!-- 处理.. -->
    <bean id="xmlAwareForm_hmc" class="org.springframework.http.converter.xml.XmlAwareFormHttpMessageConverter" /><!-- 处理.. -->
    <bean id="jaxb2RootElement_hmc" class="org.springframework.http.converter.xml.Jaxb2RootElementHttpMessageConverter" /><!-- 处理.. -->
    <bean id="jackson_hmc" class="org.springframework.http.converter.json.MappingJacksonHttpMessageConverter" /><!-- 处理json-->

转载:http://elf8848.iteye.com/blog/875830
这个找到的资料是 3.1 的，但是women可以看到，最后一个配置了 Jackson 的 json 处理程序，在更新的版本中，AnnotationMethodHandlerAdapter 已经废弃，使用的是 RequestMappingHandlerAdapter，看下 RequestMappingHandlerAdapter 的源码。


	public RequestMappingHandlerAdapter() {
		StringHttpMessageConverter stringHttpMessageConverter = new StringHttpMessageConverter();
		stringHttpMessageConverter.setWriteAcceptCharset(false);  // see SPR-7316

		this.messageConverters = new ArrayList<HttpMessageConverter<?>>(4);
		this.messageConverters.add(new ByteArrayHttpMessageConverter());
		this.messageConverters.add(stringHttpMessageConverter);
		this.messageConverters.add(new SourceHttpMessageConverter<Source>());
		this.messageConverters.add(new AllEncompassingFormHttpMessageConverter());
	}

这里面没有了 json 的处理过程，我们把它加上

@EnableWebMvc
@Configuration
public class WebMvcConfig extends WebMvcConfigurerAdapter {
    
    @Bean
    public RequestMappingHandlerAdapter requestMappingHandlerAdapter() {
        RequestMappingHandlerAdapter adapter = new RequestMappingHandlerAdapter();
        
        List<HttpMessageConverter<?>> converters = adapter.getMessageConverters();

        MappingJackson2HttpMessageConverter jsonConverter = new MappingJackson2HttpMessageConverter();
        List<MediaType> supportedMediaTypes = new ArrayList<MediaType>();
        MediaType textMedia = new MediaType(MediaType.TEXT_PLAIN, Charset.forName("UTF-8"));
        supportedMediaTypes.add(textMedia);
        MediaType jsonMedia = new MediaType(MediaType.APPLICATION_JSON, Charset.forName("UTF-8"));
        supportedMediaTypes.add(jsonMedia);jsonConverter.setSupportedMediaTypes(supportedMediaTypes);
        
        converters.add(jsonConverter);
        
        
        adapter.setMessageConverters(converters);
        
       return adapter;
    }
}

成功，报错消除，正确获取到了参数