Spring with Tomcat 中文编码问题的解决方案

由于各种原因，Java 应用中有关中文编码的问题总是层出不穷，即使是在 i18n 发展已久的今日，为了能够在 Java 应用中良好地使用中文，程序员们仍然要花费许多额外的力气来调试、设置以解决有关中文编码的问题。针对在 Tomcat 服务器上运行的 Spring 应用，我总结了一些相关的经验，希望能帮助其他人在处理该问题时能少走一些弯路。以下条目纯属个人在开发中摸索出来的经验，并不一定适用于所有情况。在解决中文编码的问题时，也不一定需要将以下所罗列的条目逐一设置，往往只需要结合自己开发中的实际情况修改其中若干项目即可。

1. 修改 $CATALINA_HOME/conf/server.xml。
找到 Connector 的配置，添加 URIEncoding 属性，例如：

<Connector?URIEncoding="UTF-8"?port="8080"?protocol="HTTP/1.1"?????????? connectionTimeout="20000"?????????? redirectPort="8443"?/>

2. 修改 $CATALINA_HOME/bin/catalina.sh。(来源www.iocblog.net)
设置 CATALINA_OPTS 参数，如下：

JAVA_OPTS="$JAVA_OPTS?"-Djavax.servlet.request.encoding=UTF-8"?"-Dfile.encoding=UTF-8""

3. 修改 Web 应用中的 web.xml。
添加过滤器 CharacterEncodingFilter。如下：

<filter>????<filter-name>setCharacterEncoding</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></filter><!--?filtered?type?--><filter-mapping>????<filter-name>setCharacterEncoding</filter-name>????<url-pattern>*.do</url-pattern></filter-mapping>

4. 修改 Web 应用中的 app-servlet.xml。
找到 viewResolver bean 的配置，添加 contentType 属性，如下：

<bean?id="viewResolver"????class="org.springframework.web.servlet.view.InternalResourceViewResolver">????<property?name="viewClass"????????value="org.springframework.web.servlet.view.JstlView"?/>????<property?name="prefix"?value="/"?/>????<property?name="suffix"?value=".jsp"?/>????<property?name="contentType">????????<value>text/html;charset=UTF-8</value>????</property></bean>

5. 在 JSP 页面中添加如下一行。

<%@?page?language="java"?contentType="text/html;?charset=UTF-8"?pageEncoding="UTF-8"%>

6. 编译 war 包时需要注意指定编译器的编码。
例如，在 maven 的 pom.xml 中找到 maven-compiler-plugin 插件一节，指定 encoding：

<plugin>????<artifactId>maven-compiler-plugin</artifactId>????<configuration>????????<source>1.6</source>????????<target>1.6</target>????????<encoding>UTF-8</encoding>????</configuration></plugin>

7. 在 Controller 中覆盖 handleRequestInternal 方法，指定 response 所采用的字符编码。

@Overrideprotected?ModelAndView?handleRequestInternal(HttpServletRequest?request,????????HttpServletResponse?response)?throws?Exception?{????response.setCharacterEncoding("UTF-8");????return?super.handleRequestInternal(request,?response);}?

...