解决SpringBoot请求返回字符串中文乱码的问题

 更新时间:2024年05月31日 15:55:41   作者:古辛  
这篇文章主要介绍了解决SpringBoot请求返回字符串中文乱码的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

问题

当Controller的接口返回字符串,在SwaggerUI中测试时,发现返回都是问号,比如”?????id 100 ???????“,这是由于字符编码问题导致

例如:

ResponseEntity.status(HttpStatus.NOT_FOUND)
  .body(String.format("未找到相应id %d 的记录", id));

网上解决方案

现有的两种解决方案:

  • 第一种,针对单独接口,在RequestMapping里设置 produces = {"text/plain;charset=UTF-8"}
  • 第二种,统一在MVC配置类中,通过修改StringHttpMessageConverter默认配置,部分代码(PS,该代码从别处拷贝而来):
@Configuration
@EnableWebMvc
public class MyMvcConfig implements WebMvcConfigurer {
 
    @Bean
    public HttpMessageConverter<String> responseBodyStringConverter() {
        StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8);
        return converter;
    }
 
 
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters){
        converters.add(responseBodyStringConverter());
    }
}

是由于默认的编码是”StandardCharsets.ISO_8859_1“导致,是通过重写”configureMessageConverters“方法来设置UTF-8编码来解决。

也就是第二种,坑了我,也许是我使用不当?

新解决方案

通过研究源码,找到了新的解决思路:

因为通过重写”configureMessageConverters“方法后,会导致一些其他问题

比如,统一处理异常的ExceptionAdviceHandler不工作,还导致Controller接口不支持文件下载

比如:

//解决中文文件名的乱码问题
String utf8 = StandardCharsets.UTF_8.name();
try {
    downloadFileName = URLEncoder.encode(downloadFileName, utf8);
} catch (UnsupportedEncodingException e) {
    //
}
 
return ResponseEntity.ok()
        .contentType(MediaType.APPLICATION_OCTET_STREAM)
        .header(HttpHeaders.CONTENT_DISPOSITION,
                "attachment; filename* = " + utf8 + "''" + downloadFileName)
        .body(new UrlResource(downloadFile.toURI()));

并且调用下载接口时,会报406错误和异常”No converter for [class org.springframework.core.io.UrlResource]”,意思是不支持 “application/octet-stream“的转换,见鬼了,通过测试,禁用掉WebMvcConfigurer的重写,下载功能就ok了,但是会重新有编码问题。

最终通过研究源码,找到了根源,这是由于设置了自己的converter导致默认的其他converters不会再被初始化添加导致,参见WebMvcConfigurationSupport的代码:

    protected final List<HttpMessageConverter<?>> getMessageConverters() {
        if (this.messageConverters == null) {
            this.messageConverters = new ArrayList();
            this.configureMessageConverters(this.messageConverters);
            if (this.messageConverters.isEmpty()) {
                this.addDefaultHttpMessageConverters(this.messageConverters);
            }
 
            this.extendMessageConverters(this.messageConverters);
        }
 
        return this.messageConverters;
    }

所以基于这个代码,我们则应该重写extendMessageConverters方法来达到目的,最终的代码是:

   @Bean
    public HttpMessageConverter<String> responseBodyStringConverter() {
        StringHttpMessageConverter converter = new StringHttpMessageConverter(StandardCharsets.UTF_8);
        return converter;
    }
 
    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        List<StringHttpMessageConverter> stringHttpMessageConverters = converters.stream()
                .filter(converter -> converter.getClass().equals(StringHttpMessageConverter.class))
                .map(converter -> (StringHttpMessageConverter) converter)
                .collect(Collectors.toList());
 
        if (stringHttpMessageConverters.isEmpty()) {
            converters.add(responseBodyStringConverter());
        } else {
            stringHttpMessageConverters.forEach(converter -> converter.setDefaultCharset(StandardCharsets.UTF_8));
        }
    }

JSON格式的编码探讨

这里仅处理接口直接返回字符串的问题,而对于处理JSON返回,这是因为JSON返回由MappingJackson2HttpMessageConverter来控制:

	protected JsonEncoding getJsonEncoding(@Nullable MediaType contentType) {
		if (contentType != null && contentType.getCharset() != null) {
			Charset charset = contentType.getCharset();
			for (JsonEncoding encoding : JsonEncoding.values()) {
				if (charset.name().equals(encoding.getJavaName())) {
					return encoding;
				}
			}
		}
		return JsonEncoding.UTF8;
	}

所以对于返回JSON对象,无需处理,且已经提供了默认的UTF-8编码,因为当默认没有设置MediaType的编码格式时,则会使用该默认的UTF-8编码。

并且MediaType中针对JSON的编码有如下解释:

	/**
	 * A String equivalent of {@link MediaType#APPLICATION_JSON_UTF8}.
	 * @deprecated as of 5.2 in favor of {@link #APPLICATION_JSON_VALUE}
	 * since major browsers like Chrome
	 * <a href="https://bugs.chromium.org/p/chromium/issues/detail?id=438464" rel="external nofollow" >
	 * now comply with the specification</a> and interpret correctly UTF-8 special
	 * characters without requiring a {@code charset=UTF-8} parameter.
	 */
	@Deprecated
	public static final String APPLICATION_JSON_UTF8_VALUE = "application/json;charset=UTF-8";

PS:org.springframework.boot:spring-boot-starter-web:jar:2.2.1.RELEASE

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • java web实现网上手机销售系统

    java web实现网上手机销售系统

    这篇文章主要为大家详细介绍了java web实现网上手机销售系统,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-08-08
  • JAVA入门教学之快速搭建基本的springboot(从spring boot到spring cloud)

    JAVA入门教学之快速搭建基本的springboot(从spring boot到spring cloud)

    本文主要入门者介绍怎么搭建一个基础的springboot环境,本文通过图文并茂的形式给大家介绍从spring boot到spring cloud的完美搭建过程,适用java入门教学,需要的朋友可以参考下
    2021-02-02
  • Java中的CopyOnWriteArrayList深入解读

    Java中的CopyOnWriteArrayList深入解读

    这篇文章主要介绍了Java中的CopyOnWriteArrayList深入解读,在 ArrayList 的类注释上,JDK 就提醒了我们,如果要把 ArrayList 作为共享变量的话,是线程不安全的,需要的朋友可以参考下
    2023-12-12
  • Java持久化框架Hibernate与Mybatis优劣及选择详解

    Java持久化框架Hibernate与Mybatis优劣及选择详解

    这篇文章主要介绍了Java持久化框架Hibernate与Mybatis优劣及选择详解,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-05-05
  • java后端实现信息分页查询的示例代码

    java后端实现信息分页查询的示例代码

    在一个页面展示大量的用户信息不便于观看,因此就需要采用分页展示的方法,本文就来为大家介绍一下java后端如何实现信息分页查询,需要的小伙伴可以参考下
    2023-11-11
  • idea springboot jdk maven版本兼容关系(最新推荐)

    idea springboot jdk maven版本兼容关系(最新推荐)

    文章总结了SpringBoot、JDK、Maven和IntelliJIDEA之间的版本兼容性推荐,帮助开发者避免版本冲突和“版本地狱”,建议使用SpringBoot 3.3和JDK 21进行新项目开发,使用SpringBoot 2.7和JDK 17进行企业稳定项目开发,感兴趣的朋友跟随小编一起看看吧
    2025-12-12
  • 探讨Java 将Markdown文件转换为Word和PDF文档

    探讨Java 将Markdown文件转换为Word和PDF文档

    这篇文章主要介绍了Java 将Markdown文件转换为Word和PDF文档,本文通过分步指南及代码示例展示了如何将 Markdown 文件转换为 Word 文档和 PDF 文件,需要的朋友可以参考下
    2024-07-07
  • 详解在Java程序中运用Redis缓存对象的方法

    详解在Java程序中运用Redis缓存对象的方法

    这篇文章主要介绍了在Java程序中运用Redis缓存对象的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-03-03
  • java 重定义数组的实现方法(与VB的ReDim相像)

    java 重定义数组的实现方法(与VB的ReDim相像)

    java 重定义数组的实现方法(与VB的ReDim相像),需要的朋友可以参考一下
    2013-04-04
  • 解决for循环为空不需要判断的问题

    解决for循环为空不需要判断的问题

    这篇文章主要介绍了解决for循环为空不需要判断的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-09-09

最新评论