Spring 请求参数乱码

背景

今天开发了一个Post接口，用来修改Bug的信息，post的参数有中文，作为一个初学者只能上网查查别的解决方案了，大部分的解决方案都差不多，但是参照别人的方案配置上以下配置之后，却没有解决。
配置如下:

    <filter>  
        <filter-name>encodingFilter</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>  
    <filter-mapping>  
        <filter-name>encodingFilter</filter-name>  
        <url-pattern>/*</url-pattern>  
    </filter-mapping> 

折腾了很久还是没有解决。中午吃饭时刚好配到一个java大牛，跟他讲讲我的问题，他给我的建议不是遇到问题就去查别人是怎么解决的，应该要自己动手解决，特别是针对java这门语言，生态圈很大，事事都靠别人，成长很慢。
接受大牛的指导，尝试一下自己解决。

解决过程

既然配置了filter，还是有问题，只能一步一步的排查原因了。

查看request编码

在controller里添加上HttpServletRequest 参数，确认一下request的编码。

@RequestMapping(value = "/bug/update", method = RequestMethod.POST)
public UpdateBugResult updateBug(UpdateBugParam param, HttpServletRequest request){
     System.out.println(request.getCharacterEncoding());
}

打印出来的编码是: UTF-8。

配置tomcat编码

request的编码没有问题，CharacterEncodingFilter的配置也没有问题，那是不是tomcat的问题呢，修改下tomcat的配置, 打开 config/server.xml，找到下面这一行:

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443"/>

修改为:

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

添加了URIEncoding=”UTF-8”这个配置项。
但是还是没有解决，还是乱码。

确认哪儿种编码

到这一步，只能查查看到底是哪儿种编码导致了乱码。
打印几种编码解码后的结果:

        System.out.println(request.getCharacterEncoding());\\1
        System.out.println(param.getProductName());\\2
        try {
            System.out.println(new String(param.getProductName().getBytes(), "UTF-8"));\\3
            System.out.println(new String(param.getProductName().getBytes("ISO8859-1"), "UTF-8"));\\4
            System.out.println(new String(param.getProductName().getBytes("ISO8859-1"), "UTF-8"));\\5
        }catch (Exception e){
            e.printStackTrace();
        }

在第4行时，就正确输出了结果。

最终解决

编码方式找到了，是”ISO8859-1”，但是各个环节都排查了，为什么不是”UTF-8”呢，难道是因为新项目配置不正确。试试把filter的配置移到最上面试试。
最终的web.xml文件如下:

<web-app id="WebApp_ID" version="2.4"
         xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee
  http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

  <display-name>Spring Web MVC Application</display-name>

  <filter>
    <filter-name>encodingFilter</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>
  <filter-mapping>
    <filter-name>encodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>

  <context-param>
    <param-name>contextConfigLocation</param-name>
    <param-value>classpath*:spring/application-*.xml,classpath:cas/applicationContext-casFilter.xml</param-value>
  </context-param>
  <listener>
    <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
  </listener>

  <filter>
    <filter-name>springSecurityFilterChain</filter-name>
    <filter-class>org.springframework.web.filter.DelegatingFilterProxy</filter-class>
  </filter>
  <filter-mapping>
    <filter-name>springSecurityFilterChain</filter-name>
    <url-pattern>/*</url-pattern>
  </filter-mapping>
  <listener>
    <listener-class>
      org.jasig.cas.client.session.SingleSignOutHttpSessionListener
    </listener-class>
  </listener>

  <servlet>
    <servlet-name>mvc-dispatcher</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
  </servlet>

  <servlet-mapping>
    <servlet-name>mvc-dispatcher</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>
</web-app>

到此时问题解决。

总结

java的编码问题一直都是很让人头疼的问题(这句话是大牛说的)，遇到这类的问题，只能一步一步的排查解决。再难也不能放弃治疗。