快捷導(dǎo)航

解決SpringBoot請(qǐng)求返回字符串中文亂碼的問(wèn)題

更新時(shí)間：2024年05月31日 15:55:41 作者：古辛

這篇文章主要介紹了解決SpringBoot請(qǐng)求返回字符串中文亂碼的問(wèn)題,具有很好的參考價(jià)值,希望對(duì)大家有所幫助,如有錯(cuò)誤或未考慮完全的地方,望不吝賜教

問(wèn)題

當(dāng)Controller的接口返回字符串，在SwaggerUI中測(cè)試時(shí)，發(fā)現(xiàn)返回都是問(wèn)號(hào)，比如”?????id 100 ???????“，這是由于字符編碼問(wèn)題導(dǎo)致

例如：

ResponseEntity.status(HttpStatus.NOT_FOUND)
  .body(String.format("未找到相應(yīng)id %d 的記錄", id));

網(wǎng)上解決方案

現(xiàn)有的兩種解決方案：

第一種，針對(duì)單獨(dú)接口，在RequestMapping里設(shè)置 produces = {"text/plain;charset=UTF-8"}
第二種，統(tǒng)一在MVC配置類(lèi)中，通過(guò)修改StringHttpMessageConverter默認(rèn)配置，部分代碼（PS，該代碼從別處拷貝而來(lái)）：

@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());
    }
}

是由于默認(rèn)的編碼是”StandardCharsets.ISO_8859_1“導(dǎo)致，是通過(guò)重寫(xiě)”configureMessageConverters“方法來(lái)設(shè)置UTF-8編碼來(lái)解決。

也就是第二種，坑了我，也許是我使用不當(dāng)？

新解決方案

通過(guò)研究源碼，找到了新的解決思路：

因?yàn)橥ㄟ^(guò)重寫(xiě)”configureMessageConverters“方法后，會(huì)導(dǎo)致一些其他問(wèn)題

比如，統(tǒng)一處理異常的ExceptionAdviceHandler不工作，還導(dǎo)致Controller接口不支持文件下載

比如：

//解決中文文件名的亂碼問(wèn)題
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()));

并且調(diào)用下載接口時(shí)，會(huì)報(bào)406錯(cuò)誤和異常”No converter for [class org.springframework.core.io.UrlResource]”，意思是不支持 “application/octet-stream“的轉(zhuǎn)換，見(jiàn)鬼了，通過(guò)測(cè)試，禁用掉WebMvcConfigurer的重寫(xiě)，下載功能就ok了，但是會(huì)重新有編碼問(wèn)題。

最終通過(guò)研究源碼，找到了根源，這是由于設(shè)置了自己的converter導(dǎo)致默認(rèn)的其他converters不會(huì)再被初始化添加導(dǎo)致，參見(jiàn)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;
    }

所以基于這個(gè)代碼，我們則應(yīng)該重寫(xiě)extendMessageConverters方法來(lái)達(dá)到目的，最終的代碼是：

   @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格式的編碼探討

這里僅處理接口直接返回字符串的問(wèn)題，而對(duì)于處理JSON返回，這是因?yàn)镴SON返回由MappingJackson2HttpMessageConverter來(lái)控制：

	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;
	}

所以對(duì)于返回JSON對(duì)象，無(wú)需處理，且已經(jīng)提供了默認(rèn)的UTF-8編碼，因?yàn)楫?dāng)默認(rèn)沒(méi)有設(shè)置MediaType的編碼格式時(shí)，則會(huì)使用該默認(rèn)的UTF-8編碼。

并且MediaType中針對(duì)JSON的編碼有如下解釋?zhuān)?/p>

	/**
	 * 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  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