Spring MVC 中解决中文乱码问题

在 Spring MVC 中解决中文乱码问题，需要从 请求参数编码 和 响应内容编码 两方面入手。以下是完整的解决方案：

---

一、解决请求参数中文乱码

1. POST 请求编码（表单提交）

配置 CharacterEncodingFilter
在 web.xml 中添加 Spring 提供的字符编码过滤器，强制请求和响应使用 UTF-8 编码：

<!-- 解决 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>

2. GET 请求编码（URL 参数）

修改 Tomcat 的 server.xml
在 Tomcat 的 conf/server.xml 文件中，找到 Connector 配置，添加 URIEncoding="UTF-8"：

<Connector 
    port="8080" 
    protocol="HTTP/1.1"
    URIEncoding="UTF-8"  <!-- 关键配置 -->
    connectionTimeout="20000"
    redirectPort="8443" />

---

二、解决响应内容中文乱码

1. 配置消息转换器（JSON 响应）

在 Spring MVC 配置文件中（如 spring-mvc.xml），设置 MappingJackson2HttpMessageConverter 的默认编码：

<mvc:annotation-driven>
    <mvc:message-converters>
        <bean class="org.springframework.http.converter.StringHttpMessageConverter">
            <property name="supportedMediaTypes">
                <list>
                    <value>text/plain;charset=UTF-8</value>
                    <value>text/html;charset=UTF-8</value>
                </list>
            </property>
        </bean>
        <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
            <property name="supportedMediaTypes">
                <list>
                    <value>application/json;charset=UTF-8</value>
                </list>
            </property>
        </bean>
    </mvc:message-converters>
</mvc:annotation-driven>

2. 全局响应编码配置

在 web.xml 中添加响应编码过滤器：

<filter>
    <filter-name>responseFilter</filter-name>
    <filter-class>org.springframework.web.filter.HttpPutFormContentFilter</filter-class>
</filter>
<filter-mapping>
    <filter-name>responseFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

---

三、其他注意事项

1. JSP 页面编码设置

确保 JSP 页面头部声明了 UTF-8 编码：

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

2. 数据库连接编码

如果涉及数据库操作，在 JDBC URL 中指定字符集：

jdbc.url=jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8

3. Ajax 请求编码

对于前端 Ajax 请求（如 jQuery），显式设置 contentType：

$.ajax({
    url: '/api/data',
    type: 'POST',
    contentType: 'application/x-www-form-urlencoded; charset=UTF-8', // 明确设置编码
    data: { name: '张三' },
    success: function(response) {
        console.log(response);
    }
});

---

四、验证配置是否生效

1. POST 请求测试
   提交表单后，观察后端是否能正确接收中文参数。

2. GET 请求测试
   访问带中文参数的 URL，如 http://localhost:8080/user?name=张三，检查是否乱码。

3. 响应内容测试
   返回 JSON 数据或视图页面，确认中文字符正常显示。

---

五、常见问题排查

1. 乱码仅在部分场景出现

   • 检查是否遗漏了 GET 请求的 Tomcat 配置。
   • 确认前端请求头 Content-Type 是否携带 charset=UTF-8。

2. Spring Boot 项目配置
   在 application.properties 中添加：

   server.servlet.encoding.force=true
   server.servlet.encoding.charset=UTF-8
   

3. Tomcat 9+ 的兼容性
   新版 Tomcat 默认使用 UTF-8 编码，但仍需确保 URIEncoding 配置正确。

---

通过以上步骤，可以彻底解决 Spring MVC 中的中文乱码问题！