SpringMVC解决请求中文乱码问题

一、解决中文乱码问题

        SpringMVC在POST请求中接受的参数值为中文时，会出现乱码问题，此时需要注册一个CharacterEncodingFilter过滤器来解决中文乱码的问题。

在web.xml中通过<filter>标签注册过滤器，指定初始化参数，并通过<filter-mapping>标签指定要过滤的请求URL。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
         version="4.0">
    <!-- 注册CharacterEncodingFilter，解决POST请求中文乱码问题 -->
    <filter>
        <filter-name>characterEncodingFilter</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>

    <!-- 所有请求都先走CharacterEncodingFilter -->
    <filter-mapping>
        <filter-name>characterEncodingFilter</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>
</web-app>

注意：CharacterEncodingFilter必须在其他filter注册之前进行注册，所有的请求必须先通过CharacterEncodingFilter过滤，再进入其他Filter。

二、CharacterEncodingFilter源码

        当接受到请求之后，会先进入CharacterEncodingFilter过滤器，执行doFilterInternal方法，判断是否设置了encoding字符编码。如果指定了字符编码，会判断是否要处理请求对象的编码问题（forceRequestEncoding是否为true），以及是否要处理响应对象的编码问题（forceResponseEncoding是否为true），根据判断结果分别调用 HttpServletRequest 和 HttpServletResponse 对象的setCharacterEncoding()方法设置字符编码。

CharacterEncodingFilter源码（这里只展示部分源码）：

// org.springframework.web.filter.CharacterEncodingFilter
public class CharacterEncodingFilter extends OncePerRequestFilter {

	@Nullable
	private String encoding;    // 要设置的字符编码

	private boolean forceRequestEncoding = false;        // 是否处理请求对象乱码问题

	private boolean forceResponseEncoding = false;       // 是否处理响应对象乱码问题

    // other code ...

    // 核心方法，在这个方法中处理乱码问题
    @Override
	protected void doFilterInternal(
			HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
	        throws ServletException, IOException {
        
        // 获取设置的字符集
		String encoding = getEncoding();
        // 判断字符集是否为空
		if (encoding != null) {
            // 判断 forceRequestEncoding 是否为true（是否处理请求对象乱码） 或者 之前没有设置过字符集，两个条件满足一个即可
			if (isForceRequestEncoding() || request.getCharacterEncoding() == null) {
                // 调用request对象的setCharacterEncoding方法设置字符集
				request.setCharacterEncoding(encoding);
			}
            // 判断 forceResponseEncoding 是否为true（是否处理响应对象乱码问题）
			if (isForceResponseEncoding()) {
                // 调用response对象的setCharacterEncoding方法设置字符集
				response.setCharacterEncoding(encoding);
			}
		}
        // 放行请求
		filterChain.doFilter(request, response);
	}

}