Java Request 乱码终极解决方案：从GET到POST，一次搞定所有编码问题！

** 还在为Java Web开发中request请求的中文乱码问题抓狂吗？GET乱码？POST乱码？JSON乱码？本文将作为你的“乱码克星”，从根源到实践，彻底剖析Java request乱码的各种场景，并提供最清晰、最可靠的解决方案，让你从此告别“？？？”，编码之路畅通无阻！

引言：乱码，每个Java开发者都曾遇到的“噩梦”

“老师，我表单提交的中文怎么全变成问号了？” “我的接口对接方说收到的数据是乱码，怎么办？”

在Java Web开发的日常中，request 乱码问题堪称“家常便饭”，却又是最令人头疼的顽疾，它不仅影响开发效率，更可能在生产环境中造成严重的数据错误和业务损失。

别担心,你不是一个人在战斗，我们就来系统地梳理一下这个问题的来龙去脉，并提供一套“标本兼治”的终极解决方案，无论你是初学者还是资深开发者，读完这篇文章，你都能自信地应对任何request乱码场景。

乱码的根源：字符编码“失联”了

要解决问题,必先理解其根源，乱码的本质只有一个：编码与解码使用的字符集不一致。

想象一下,你有一封用中文写的信（原始字符）。

1. 编码（Encode）： 你把它翻译成摩斯电码（字节流），这个过程使用的规则是 UTF-8。
2. 传输： 这串摩斯电码通过网络发送出去。
3. 解码（Decode）： 收信人收到摩斯电码后，需要用同样的规则 UTF-8 来翻译，才能还原成中文。

如果收信人错误地使用了 ISO-8859-1（一个只支持英文的编码）来翻译，那么中文自然就会变成一堆无法识别的乱码。

在Java Web中：

• 浏览器 是“写信人”，它会对表单数据进行编码。
• Tomcat（或其他服务器） 是“邮局”，它接收字节流。
• 我们的Java代码 是“收信人”，通过 request 对象读取数据，并进行解码。

当浏览器编码、服务器默认解码、我们手动解码这三者使用的字符集不匹配时，乱码就产生了。

分场景击破：GET请求与POST请求的乱码处理

request 乱码主要分为两大类：GET 请求和 POST 请求，它们的处理方式截然不同，必须区分对待。

GET请求乱码

GET请求的数据是通过URL的 QueryString 传递的，http://localhost:8080/test?name=张三&city=北京。

问题分析： 浏览器对URL中的参数进行了 UTF-8 编码，在早期版本的Tomcat（如Tomcat 7及以下）中，其默认的 URIEncoding 是 ISO-8859-1，当服务器用 ISO-8859-1 去解码 UTF-8 编码的字符时，乱码就出现了。

解决方案（两种方法，推荐第一种）：

方法1：修改Tomcat配置（治本之策）

这是最推荐、最彻底的解决方案，在Tomcat的 conf/server.xml 文件中，找到你的 <Connector> 配置节点，添加 URIEncoding="UTF-8" 属性。

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8" /> <!-- 添加这一行 -->

优点： 一劳永逸，所有通过该Tomcat部署的GET请求都不会再出现乱码问题。 注意： 修改后需要重启Tomcat服务器才能生效。

方法2：在代码中手动处理（应急之策）

如果你无法修改服务器配置,或者只是临时处理，可以在代码中对获取到的参数进行二次编码转换。

// 假设 name 是乱码的参数
String name = request.getParameter("name");
// 用 ISO-8859-1 编码成字节，再用 UTF-8 解码成字符串
if (name != null) {
    name = new String(name.getBytes("ISO-8859-1"), "UTF-8");
}

原理： 这相当于模拟了服务器用 ISO-8859-1 解码的过程，然后我们再用正确的 UTF-8 重新解码一次。

POST请求乱码

POST请求的数据是在请求体中传输的,服务器在读取请求体时，会使用一个默认的字符集来解码。

问题分析： 在Servlet规范中，request 对象在获取参数（如 request.getParameter()）时，会调用 request.setCharacterEncoding() 方法来设置解码的字符集，这个方法必须在第一次调用 getParameter() 之前执行，否则无效。

很多初学者会忘记设置,或者设置得太晚，导致服务器使用其默认的 ISO-8859-1 字符集去解码 UTF-8 编码的请求体，从而产生乱码。

解决方案：

过滤器（Filter）—— 最优雅、最通用的解决方案

对于POST请求乱码,我们不应该在每个Servlet中都重复写一遍设置编码的代码，最佳实践是使用过滤器，它可以在所有请求到达Servlet之前，统一设置字符编码。

创建一个编码过滤器 EncodingFilter.java

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;
@WebFilter("/*") // 过滤所有请求
public class EncodingFilter implements Filter {
    private String encoding = "UTF-8";
    public void init(FilterConfig filterConfig) throws ServletException {
        // 可以从web.xml中读取配置的编码
        String encodingParam = filterConfig.getInitParameter("encoding");
        if (encodingParam != null) {
            this.encoding = encodingParam;
        }
    }
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
            throws IOException, ServletException {
        // 1. 设置请求编码
        request.setCharacterEncoding(encoding);
        // 2. 设置响应编码（防止响应也乱码）
        response.setCharacterEncoding(encoding);
        response.setContentType("text/html;charset=" + encoding);
        // 3. 将请求传递给下一个过滤器或目标Servlet
        chain.doFilter(request, response);
    }
    public void destroy() {
        // 过滤器销毁时执行
    }
}

web.xml 配置（可选，推荐使用注解）

如果你更喜欢 web.xml 的配置方式，可以这样写：

<filter>
    <filter-name>EncodingFilter</filter-name>
    <filter-class>com.yourpackage.EncodingFilter</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>

优点：

• 一劳永逸： 一次配置，所有POST请求自动解决乱码。
• 代码整洁： 业务代码中无需再关心编码问题。
• 可维护性高： 如需更换编码，只需修改一处。

进阶挑战：JSON数据的乱码处理

在现代前后端分离架构中,后端接收到的更多是JSON格式的数据，如果前端使用 axios 等库发送 Content-Type: application/json 的请求，上述方法可能失效。

问题分析： request.setCharacterEncoding("UTF-8") 只对 application/x-www-form-urlencoded（即表单提交）类型的请求体有效，对于JSON数据，我们需要使用专门的库（如 Jackson, Gson, Fastjson）来解析，这些库在解析时会自行处理字符编码，问题通常出在服务器对请求体的解析上。

解决方案：

使用 HttpServlet 的 getInputStream() 或 getReader()

框架（如Spring Boot）通常已经内置了对JSON请求体的自动解析和编码处理，但在原生Servlet中，你需要手动读取并解析。

// 假设我们使用 Jackson
import com.fasterxml.jackson.databind.ObjectMapper;
// 在Servlet的doPost方法中
BufferedReader reader = request.getReader(); // 这一步会使用正确的编码吗？
StringBuilder sb = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
    sb.append(line);
}
// ObjectMapper 默认会处理UTF-8编码
ObjectMapper mapper = new ObjectMapper();
User user = mapper.readValue(sb.toString(), User.class);

关键点：

1. 确保前端发送请求时，在请求头中明确指定 Content-Type: application/json; charset=UTF-8，这是最重要的约定！
2. 后端使用的JSON库（如Jackson）默认就是使用UTF-8编码，只要服务器能正确读取到请求体，就不会乱码。
3. 如果后端是Spring Boot项目，只需在配置文件中确保 server.servlet.encoding.enabled=true 和 server.servlet.encoding.charset=UTF-8，框架会自动处理所有编码问题。

总结与最佳实践

【我的终极建议】

为了彻底告别Java request乱码，请遵循以下黄金组合：

1. 服务器层面： 统一将所有Tomcat（或其他服务器）的 URIEncoding 和 Connector 的 encoding 都设置为 UTF-8。
2. 应用层面： 在你的Web应用中，配置一个全局的字符编码过滤器（EncodingFilter），专门处理POST请求和响应。
3. 开发规范： 与前端团队约定好，所有数据交互（特别是JSON）都必须在请求头中明确声明 charset=UTF-8。

遵循以上三步,你的Java项目将具备“金刚不坏之身”，再也不会被乱码问题所困扰。

希望这篇文章能真正帮助你解决“java request 乱码”的烦恼！如果你觉得有用，欢迎点赞、收藏并分享给更多有需要的朋友，有任何问题，欢迎在评论区留言讨论！