这篇文章主要介绍了解决SpringBoot请求返回字符串中文乱码的问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教

问题
网上解决方案
新解决方案
JSON格式的编码探讨
总结

问题
当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

总结
以上为个人经验，希望能给大家一个参考，也希望大家多多支持