前言

經(jīng)常有讀者在公眾號(hào)上問 JavaWeb 亂碼的問題，昨天又有一個(gè)小伙伴問及此事，其實(shí)這個(gè)問題很簡(jiǎn)單，但是想要說清楚卻并不容易，因?yàn)槊總€(gè)人亂碼的原因都不一樣，給每位小伙伴都把亂碼的原因講一遍也挺費(fèi)時(shí)間的，因此，松哥今天決定寫一篇文章，和大伙好好捋捋 JavaWeb 中的亂碼問題。

對(duì)于一些老司機(jī)而言，其實(shí)并不太容易遇到亂碼問題，但是對(duì)于一些新手來說，亂碼幾乎是家常便飯，而且每當(dāng)亂碼時(shí)，網(wǎng)上搜了一大堆解決方案，發(fā)現(xiàn)自己的問題還是沒能解決，其實(shí)這就是平時(shí)研究代碼不求甚解導(dǎo)致的，亂碼問題，也要去分析，然后才能對(duì)癥下藥，才能藥到病除。

整體思路

首先出現(xiàn)亂碼之后，要先去確認(rèn)亂碼的地方，當(dāng)一個(gè)網(wǎng)頁上出現(xiàn)亂碼，有可能是瀏覽器顯示問題，也有可能是 Java 編碼問題，也有可能數(shù)據(jù)庫中的數(shù)據(jù)本身就是亂碼的，所以我們要做的第一件事就是確認(rèn)亂碼發(fā)生的位置，縮小 bug 范圍，通過打印日志或者 debug 首先去確認(rèn)亂碼發(fā)生的位置，然后再去進(jìn)一步解決，一般來說，亂碼的原因大致上可以分為兩類：

• 請(qǐng)求亂碼
• 響應(yīng)亂碼

請(qǐng)求亂碼，可能是因?yàn)閰?shù)放在 URL 地址中亂碼，也有可能是參數(shù)放在請(qǐng)求體中亂碼，不同傳參方案也對(duì)應(yīng)了不同的亂碼解決方案。如果是響應(yīng)亂碼，那么原因就會(huì)比較多了，一般來說，有如下幾種可能的原因：

• 數(shù)據(jù)庫本身亂碼
• 數(shù)據(jù)在 Java 代碼中亂碼
• 數(shù)據(jù)在瀏覽器顯示的時(shí)候亂碼
• 數(shù)據(jù)在從 Java 應(yīng)用傳到數(shù)據(jù)庫的過程中亂碼

對(duì)于不同的亂碼原因，會(huì)有不同的解決方案，對(duì)癥下藥，才能藥到病除，所以當(dāng)出現(xiàn)亂碼時(shí)，大家要做的第一件事就是分析亂碼發(fā)生的原因，找到原因了，才能找到解決方案。

基本原則

發(fā)生亂碼是因?yàn)楦髯跃幋a不同導(dǎo)致的，所以，大家首先要有一個(gè)良好的開發(fā)習(xí)慣，項(xiàng)目編碼，文件編碼都要統(tǒng)一起來，松哥有個(gè)同事就因?yàn)?Freemarker 亂碼，找了半天沒找到原因，后來在松哥建議下修改了項(xiàng)目編碼，亂碼問題才解決了，一般來說，公司制度稍微成熟一些，都會(huì)對(duì)項(xiàng)目編碼，文件編碼有硬性規(guī)定的。在Eclipse 中，設(shè)置項(xiàng)目編碼方式如下（工程的編碼要提前設(shè)置，如果項(xiàng)目已經(jīng)開發(fā)一半再去設(shè)置，已有的中文就會(huì)亂碼）：

Window->Preferences->General

然后對(duì)于 JSP 文件也需要提前設(shè)置好編碼方式，如下：

這是在 Eclipse 中設(shè)置文件編碼，如果是在 IntelliJ IDEA中，則不需要設(shè)置JSP文件編碼，因?yàn)槟J(rèn)就是 UTF-8，只需要提前設(shè)置下工程編碼即可：

除了開發(fā)工具的編碼，數(shù)據(jù)庫的編碼也要統(tǒng)一，一般來說，主要是設(shè)置一下數(shù)據(jù)庫的編碼和數(shù)據(jù)表的編碼，如下：

設(shè)置數(shù)據(jù)庫編碼：

CREATE DATABASE `vhr` DEFAULT CHARACTER SET utf8;

設(shè)置數(shù)據(jù)表編碼：

DROP TABLE IF EXISTS `adjustsalary`;
CREATE TABLE `adjustsalary` (
 `id` int(11) NOT NULL AUTO_INCREMENT,
 `eid` int(11) DEFAULT NULL,
 PRIMARY KEY (`id`),
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

這些是準(zhǔn)備工作，這些工作做好了，還是有可能會(huì)遇到亂碼問題，接下來我們就具體問題具體分析。

請(qǐng)求亂碼

請(qǐng)求亂碼，就是說數(shù)據(jù)在瀏覽器中顯示是正常的，但是傳到 Java 后端之后，就亂碼了，這種亂碼一般來說，分為兩種：

• 參數(shù)放在 URL 地址中導(dǎo)致的亂碼
• 參數(shù)放在請(qǐng)求體中導(dǎo)致的亂碼

兩種亂碼原因，對(duì)應(yīng)了兩種不同的解決方案。分別來看。

URL 地址中的參數(shù)亂碼

這種亂碼主要發(fā)生在 GET 請(qǐng)求中，因?yàn)樵?GET 請(qǐng)求中我們一般通過 URL 來傳遞參數(shù)，這個(gè)問題可以在代碼中解決，但是太過于麻煩，因此一般我們直接在Tomcat配置中解決，修改 Tomcat的conf/server.xml 文件，修改 URL 編碼格式，如下：

這樣就可以搞定 URL 地址中的參數(shù)亂碼。

請(qǐng)求體中的參數(shù)亂碼

請(qǐng)求體中的參數(shù)亂碼，我們可以在解析參數(shù)之前通過設(shè)置 HttpServletRequest 的編碼來解決，如下：

request.setCharacterEncoding("UTF-8");

但是一樣也太過于麻煩，所以如果是普通的 Servlet/JSP 項(xiàng)目，我們就可以直接定義一個(gè)過濾器來處理，如下：

public class EncodingFilter implements Filter {
 @Override
 public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
  request.setCharacterEncoding("UTF-8");
  chain.doFilter(request, response);
 }
}

過濾器配置：

 <filter>
  <filter-name>encodingFilter</filter-name>
  <filter-class>org.sang.filter.EncodingFilter</filter-class>
 </filter>
 <filter-mapping>
  <filter-name>encodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
 </filter-mapping>

在工程編碼和JSP/HTML編碼都沒問題的情況下，請(qǐng)求亂碼基本上就是這兩種情況。

響應(yīng)亂碼

如果在瀏覽器上加載頁面看到了亂碼，大家首先要確認(rèn)在從服務(wù)端往瀏覽器寫數(shù)據(jù)的前一刻，這個(gè)數(shù)據(jù)還沒有亂碼（即數(shù)據(jù)庫中查詢出來的數(shù)據(jù)是OK的，沒有發(fā)生亂碼的問題），那么對(duì)于這種亂碼，我們只需要設(shè)置響應(yīng)數(shù)據(jù)的 ContentType 就可以了，如下：

response.setContentType("text/html;charset=UTF-8");

如果從數(shù)據(jù)庫中查詢出來的數(shù)據(jù)就是亂碼的，那么就需要去確認(rèn)數(shù)據(jù)庫中的編碼是否 OK 。

框架處理

前面提到的方案，都是在 Servlet/JSP 項(xiàng)目中我們可以采用的方案，在 SSM 框架中當(dāng)然也可以使用，但是，SpringMVC 框架本身也提供了一個(gè)過濾器，我們可以借用這個(gè)過濾器更加高效的解決響應(yīng)亂碼問題，如下：

<filter>
 <filter-name>encoding</filter-name>
 <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
 <init-param>
  <param-name>encoding</param-name>
  <param-value>UTF-8</param-value>
 </init-param>
 <init-param>
  <param-name>forceRequestEncoding</param-name>
  <param-value>true</param-value>
 </init-param>
 <init-param>
  <param-name>forceResponseEncoding</param-name>
  <param-value>true</param-value>
 </init-param>
</filter>
<filter-mapping>
 <filter-name>encoding</filter-name>
 <url-pattern>/*</url-pattern>
</filter-mapping>

當(dāng)然，上面這段配置并不能代替 Tomcat 中 conf/server.xml 中的編碼配置，如果是在 Spring Boot 中，配置可以更加簡(jiǎn)單，只需要在 application.properties 中添加如下配置即可：

server.tomcat.uri-encoding=UTF-8
spring.http.encoding.force-request=true
spring.http.encoding.force-response=true

其他亂碼

其他亂碼主要是指使用一些第三方框架導(dǎo)致的亂碼，例如使用 Alibaba 的 fastjson，開發(fā)者就需要在配置 HttpMessageConverter 時(shí)指定編碼格式，否則就有可能出現(xiàn)亂碼，這種第三方框架的亂碼松哥沒法窮舉，大伙在使用時(shí)需要注意看官方文檔，fastjson 的 HttpMessageConverter 配置如下：

@Bean
FastJsonHttpMessageConverter fastJsonHttpMessageConverter() {
 FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();
 FastJsonConfig config = new FastJsonConfig();
 config.setCharset(Charset.forName("UTF-8"));
 converter.setFastJsonConfig(config);
 converter.setDefaultCharset(Charset.forName("UTF-8"));
 return converter;
}

一個(gè)隱蔽的亂碼

除了前面介紹的這幾種亂碼之外，還有一個(gè)比較隱蔽的亂碼，容易被很多初學(xué)者忽略的地方，就是數(shù)據(jù)在從 Java 應(yīng)用傳遞到 MySQL 的過程中，發(fā)生了亂碼，這種問題一般在 Windows 上不易發(fā)生，如果數(shù)據(jù)庫裝在 Linux 上，則這個(gè)問題就很容易發(fā)生，數(shù)據(jù)在代碼中命名沒有亂碼，存到 MySQL 上就亂碼了，但是如果直接使用 Navicat 等工具往 MySQL 上存儲(chǔ)數(shù)據(jù)，又不會(huì)亂碼，或者 MySQL 中數(shù)據(jù)沒有亂碼，但是用 Java 查詢出來就亂碼了，這種都是數(shù)據(jù)在 應(yīng)用 和 數(shù)據(jù)庫 之間傳遞時(shí)發(fā)生了亂碼，解決方式很簡(jiǎn)單，在數(shù)據(jù)庫連接地址上指定編碼即可，如下：

db.url=jdbc:mysql:///yuetong?useUnicode=true&characterEncoding=UTF-8

大致就這些，還有一些非常偶爾的情況可能會(huì)用到 @RequestMapping 注解中的 produces 屬性，在這里指定數(shù)據(jù)類型即可。

好了，差不多就這些，下次有人問你為啥我的又亂碼了，直接把這篇文章甩給他。大伙有什么解決亂碼的獨(dú)門密器也可以一起來討論。

總結(jié)

以上就是這篇文章的全部內(nèi)容了，希望本文的內(nèi)容對(duì)大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價(jià)值，謝謝大家對(duì)腳本之家的支持。

最新評(píng)論