一、Tomcat应用中文乱码问题概述
在开发基于Tomcat的Web应用时，中文乱码是一个常见且令人头疼的问题。简单来说，当我们在页面上输入中文，或者从数据库里读取中文数据显示在页面上时，可能会看到一堆乱码，而不是正常的中文字符。这不仅影响用户体验，还可能导致业务数据出现错误。
1.1 应用场景
中文乱码问题在很多场景下都会出现。比如，我们开发一个在线论坛系统，用户在发表帖子时输入中文内容，提交后却发现显示的是乱码；或者在一个电商系统里，商品名称和描述是中文，从数据库查询出来显示在网页上时变成了乱码。再比如，我们在进行文件上传下载操作时，如果文件名称包含中文，也可能会出现乱码情况。
1.2 技术优缺点
优点方面，如果能够正确解决中文乱码问题，那么我们的应用就可以完美地支持中文，提升用户体验，让系统更加国际化和友好。但解决这个问题也有一些难点，也就是所谓的“缺点”。不同的编码格式之间转换比较复杂，而且在不同的环境下（如不同的操作系统、浏览器）可能会有不同的表现，这就增加了问题排查和解决的难度。
1.3 注意事项
在解决中文乱码问题时，要注意各个环节的编码设置要保持一致。比如，页面的编码、请求的编码、响应的编码以及数据库的编码等都要统一，否则还是会出现乱码。另外，不同版本的Tomcat可能在编码设置上有一些细微的差别，需要仔细查看官方文档。
二、编码设置
2.1 Tomcat配置文件编码设置
Tomcat的配置文件 server.xml 是非常重要的，我们可以在这里进行一些编码相关的设置。打开 server.xml 文件，找到
connectionTimeout="20000" redirectPort="8443" /> 我们需要在这个标签里添加 URIEncoding 属性，将其值设置为 UTF-8，这样可以解决URL中中文参数的乱码问题。修改后的配置如下： connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8" /> 2.2 JSP页面编码设置 在JSP页面中，我们需要设置页面的编码。在JSP文件的开头添加以下代码： <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> 这里的 contentType 用于指定响应的内容类型和编码，pageEncoding 用于指定JSP页面本身的编码。通过这样的设置，JSP页面就可以正确处理中文了。 2.3 Servlet请求和响应编码设置 在Servlet中，我们需要对请求和响应的编码进行设置。以下是一个简单的Servlet示例： // Java Servlet技术栈 import javax.servlet.ServletException; import javax.servlet.annotation.WebServlet; import javax.servlet.http.HttpServlet; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; @WebServlet("/test") public class TestServlet extends HttpServlet { @Override protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException { // 设置请求编码 request.setCharacterEncoding("UTF-8"); // 设置响应编码 response.setCharacterEncoding("UTF-8"); response.setContentType("text/html; charset=UTF-8"); // 处理请求和响应 String name = request.getParameter("name"); response.getWriter().println("你好，" + name); } } 在这个示例中，我们通过 request.setCharacterEncoding("UTF-8") 设置请求的编码，通过 response.setCharacterEncoding("UTF-8") 和 response.setContentType("text/html; charset=UTF-8") 设置响应的编码。 三、过滤器配置 3.1 过滤器的作用 过滤器可以在请求到达Servlet之前或者响应返回给客户端之前对请求和响应进行处理。对于中文乱码问题，我们可以通过编写一个过滤器来统一设置请求和响应的编码，避免在每个Servlet中都重复设置编码。 3.2 编写编码过滤器 以下是一个简单的编码过滤器示例： // Java Filter技术栈 import javax.servlet.*; import javax.servlet.annotation.WebFilter; import java.io.IOException; @WebFilter("/*") public class CharacterEncodingFilter implements Filter { private String encoding; @Override public void init(FilterConfig filterConfig) throws ServletException { // 从过滤器配置中获取编码设置 encoding = filterConfig.getInitParameter("encoding"); if (encoding == null) { encoding = "UTF-8"; } } @Override public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException { // 设置请求编码 request.setCharacterEncoding(encoding); // 设置响应编码 response.setCharacterEncoding(encoding); response.setContentType("text/html; charset=" + encoding); // 继续处理请求 chain.doFilter(request, response); } @Override public void destroy() { // 过滤器销毁时的操作 } } 3.3 配置过滤器 在 web.xml 文件中配置这个过滤器，示例如下： 通过这样的配置，所有的请求都会经过这个过滤器，统一设置请求和响应的编码。 四、综合示例 4.1 完整项目示例 假设我们有一个简单的Web应用，包含一个JSP页面和一个Servlet。JSP页面用于接收用户输入的中文信息，Servlet用于处理这个信息并返回结果。 JSP页面（index.jsp） <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
Servlet（TestServlet.java）
// Java Servlet技术栈
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
@WebServlet("/test")
public class TestServlet extends HttpServlet {
@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
// 设置响应编码
response.setCharacterEncoding("UTF-8");
response.setContentType("text/html; charset=UTF-8");
// 获取请求参数
String name = request.getParameter("name");
response.getWriter().println("你好，" + name);
}
}
过滤器（CharacterEncodingFilter.java）
// Java Filter技术栈
import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;
@WebFilter("/*")
public class CharacterEncodingFilter implements Filter {
private String encoding;
@Override
public void init(FilterConfig filterConfig) throws ServletException {
encoding = filterConfig.getInitParameter("encoding");
if (encoding == null) {
encoding = "UTF-8";
}
}
@Override
public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
request.setCharacterEncoding(encoding);
response.setCharacterEncoding(encoding);
response.setContentType("text/html; charset=" + encoding);
chain.doFilter(request, response);
}
@Override
public void destroy() {
// 过滤器销毁时的操作
}
}
web.xml 配置
4.2 测试示例
将上述代码部署到Tomcat服务器上，启动服务器后，访问 index.jsp 页面。在输入框中输入中文姓名，点击提交按钮。如果一切配置正确，页面将正确显示中文信息，不会出现乱码。
五、文章总结
解决Tomcat应用中文乱码问题需要从多个方面入手，包括Tomcat配置文件的编码设置、JSP页面的编码设置、Servlet请求和响应的编码设置，以及过滤器的配置。通过统一各个环节的编码，我们可以有效地解决中文乱码问题。在实际开发中，我们要注意各个环节的编码一致性，并且根据不同的场景选择合适的解决方法。同时，使用过滤器可以提高代码的复用性，避免在每个Servlet中重复设置编码。