在Apache Tomcat中一劳永逸的汉字处理方法:从iso-8859-1到UTF-8

本文介绍了一种解决Tomcat环境下汉字编码问题的方法，通过创建自定义过滤器EncodingFilter并配置web.xml，确保所有请求和响应都使用UTF-8编码。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

今天继续做软件工程的课程设计，遇到了汉字编码问题（我是菜鸟手工流，纯J2SE）。因为要从PostgreSQL里读取数据，而PostgreSQL的编码是UTF-8，于是整个Java项目使用UTF-8编码。但是，只要数据在Tomcat中走一遍（这包括提交的表单、URL传值～～），就会变成传说中的iso-8859-1，据说可以改web.xml，但是服务器的东西总不能乱动不是？万一有其他挂在上面的网站正好不能用UTF-8来解码...翻了一下以前FRB的代码，发现可以用下面的方法解决。

首先假设网站的内容在/web下，编译好的.class文件在/web/WEB-INF/classes下。

然后在项目中新建一个filter包，在其中新建类EncodingFilter.java，代码如下：

package filter; import javax.servlet.FilterChain; import javax.servlet.Filter; import javax.servlet.FilterConfig; import javax.servlet.ServletRequest; import javax.servlet.ServletResponse; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import javax.servlet.ServletException; public class EncodingFilter implements Filter{ private String targetEncodin = "utf-8"; protected FilterConfig filterConfig; @Override public void destroy() { this.filterConfig = null; } @Override public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse,FilterChain chain) throws IOException, ServletException { HttpServletRequest request = (HttpServletRequest) servletRequest; HttpServletResponse response = (HttpServletResponse) servletResponse; request.setCharacterEncoding(this.targetEncodin); response.setCharacterEncoding(this.targetEncodin); chain.doFilter(servletRequest, servletResponse); } @Override public void init(FilterConfig config) throws ServletException { this.filterConfig = config; if(config.getInitParameter("encoding") != null && !config.getInitParameter("encoding").equals("")){ this.targetEncodin = config.getInitParameter("encoding"); } } }

用自己的过滤器把Tomcat的过滤器override后，还要在web.xml中设置一下：

/web/WEB-INF/web.xml：

<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd"> <web-app> <filter> <filter-name>charEncoding</filter-name> <filter-class>filter.EncodingFilter</filter-class> <init-param> <param-name>encoding</param-name> <param-value>UTF-8</param-value> </init-param> </filter> <filter-mapping> <filter-name>charEncoding</filter-name> <url-pattern>/*</url-pattern> </filter-mapping> </web-app>

这样，全部的汉字就正确编码为UTF-8了，甚至在URL中都可以！

PS.

张天庆老师说的对，用UTF-8才是好孩子，GBK可以靠边了～