从Tomcat服务器打开网页出现乱码，根本原因是字符编码在请求、响应、页面文件或数据库连接中存在不一致，导致浏览器以错误编码解析内容。
当你满怀期待地输入URL,看到浏览器里全是这样的乱码符号，心里肯定烦躁，别急着改代码，Tomcat乱码的原因通常就那么几个，按顺序排查，很快就能解决，下面我带你一步步拆解。
Tomcat乱码怎么解决：先确认编码不一致的源头
乱码不是偶然的,它一定意味着某个环节的编码没有对齐，多数情况下，问题出在Tomcat接收请求、处理页面、输出响应这条链路上，只要有一个环节用了不同的编码，就会出现乱码。
Tomcat服务器中文乱码的常见原因
请求编码与响应编码不匹配
浏览器发送请求时,默认使用ISO-8859-1编码，而你的页面和Tomcat容器可能期待UTF-8，如果Tomcat没有对请求参数进行转码，中文参数就会变成乱码，同样，响应时如果页面指定了UTF-8但Tomcat没有设置响应编码，浏览器可能用其他编码解析，导致显示乱码。
JSP页面文件编码与容器编码冲突
JSP文件本身有物理存储编码（比如你保存为UTF-8），但页面中通过pageEncoding声明的编码可能不同，或者Tomcat的JSP引擎默认编码不是UTF-8，当两者不一致时，页面内容就会被错误解析。
数据库连接字符集未统一
从数据库读取数据时,如果数据库表字符集、连接字符串中的characterEncoding、以及页面编码不一致，就会出现乱码，这种情况通常表现为从数据库取出的中文在页面上显示乱码，但页面静态中文正常。
网页乱码是Tomcat还是浏览器问题？三步判断法
有时候乱码是浏览器缓存或设置导致的,但更多时候是Tomcat这边的问题，你可以用三步快速判断。
- 第一步：在浏览器中手动切换编码（右键→编码→选择UTF-8或GBK），如果乱码消失，说明是Tomcat未正确通知浏览器用什么编码，问题出在响应头或页面meta声明。
- 第二步：查看页面源代码，检查
<meta charset="...">是否与服务器响应头中的Content-Type
一致，如果不一致，Tomcat的响应编码设置有问题。
- 第三步：在Tomcat的
logs/catalina.out中查看是否有编码相关的警告日志，如果出现WARNING或ERROR，说明Tomcat内部处理编码时出错。
两步走下来,就可以确定主要责任在Tomcat还是浏览器。
Tomcat服务器中文乱码的排查步骤与实操命令
下面我按顺序列出最有效的排查步骤,每一步都附带可验证的操作。
检查Tomcat的server.xml配置
Tomcat的conf/server.xml中，Connector节点有一个URIEncoding属性，控制请求参数的编码，默认是ISO-8859-1，必须改为UTF-8。
- 打开
{tomcat-home}/conf/server.xml。 - 找到HTTP和AJP的
Connector- 添加或修改属性：
URIEncoding="UTF-8"。- 如果需要同时控制请求体和响应体,可以加上
useBodyEncodingForURI="true"，让请求体编码与页面相同。 - 添加或修改属性：
示例（修改后）：
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" />
修改后务必重启Tomcat,这一步解决的是请求参数乱码问题。
确认JSP页面编码声明
JSP页面头部必须同时指定pageEncoding和contentType，且两者一致，推荐使用UTF-8。
- 在JSP第一行添加：
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> - 在
<head>中添加：<meta charset="UTF-8">
这两处通知浏览器用UTF-8解析页面，如果contentType和meta不一致，浏览器可能选择错。
设置过滤器统一编码
对于Servlet或Spring MVC项目，使用一个编码过滤器可以强制所有请求和响应使用指定编码，这是最彻底的方法，能覆盖所有进入应用的请求。
- 在
web.xml中添加CharacterEncodingFilter（来自Spring Web或自己写一个）。 - 设置
encoding
- 确保
forceEncoding为true，这样会强制覆盖请求和响应编码。
示例（基于Spring的配置）：
<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>
<init-param>
<param-name>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/</url-pattern>
</filter-mapping>
这个方法可以避免在每一个Servlet或JSP中单独设置编码,业内专家指出，这是企业级应用中最常用的统一编码方案。
验证数据库连接字符串
如果乱码只在显示数据库内容时出现,检查连接字符串的characterEncoding参数。
- 对于MySQL：在JDBC URL中添加
useUnicode=true&characterEncoding=UTF-8。 - 对于PostgreSQL：添加
charSet=UTF-8。 - 同时确保数据库表和字段的字符集是
utf8mb4或utf8。
示例（MySQL）：
jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai修改后重启应用,如果数据库本身存在乱码数据，需要先修复数据。
Tomcat UTF-8乱码设置：从开发到部署的完整清单
为了避免反复出现乱码,你可以从开发阶段开始就建立一套编码规范，行业共识认为，统一使用UTF-8是解决乱码的最简单策略。
开发环境中的编码规范
- 开发工具（如IntelliJ IDEA、Eclipse）的默认文件编码设为UTF-8。
- 所有JSP、HTML、CSS、JS文件保存时使用UTF-8 without BOM。
- 使用Maven或Gradle时,在
pom.xml或build.gradle中设置项目编码为UTF-8。 - 在持续集成流程中,增加编码检查步骤，避免编码不一致的代码提交。
部署时的配置核对表
你可以使用这个表格来快速核对关键配置：
| 检查项 | 正确配置 | 常见错误 |
|---|---|---|
| server.xml的URIEncoding | URIEncoding="UTF-8" |
未设置或设为ISO-8859-1 |
| JSP页面声明 | pageEncoding="UTF-8"，contentType="text/html; charset=UTF-8" |
缺少声明，或与meta不一致 |
| 过滤器 | 强制编码为UTF-8，过滤所有请求 | 未使用过滤器，或只在部分路径使用 |
| 数据库连接 | characterEncoding=UTF-8 |
使用系统默认编码，或未指定 |
| 操作系统区域设置 | 使用UTF-8的locale（如en_US.UTF-8） | 使用非UTF-8 locale，影响Tomcat默认编码 |
逐项核对后,再启动Tomcat，乱码问题基本可以解决。
关于Tomcat服务器乱码的常见问题解答
问：我修改了server.xml的URIEncoding，但中文参数还是乱码，为什么？
答：检查是否修改了正确的Connector，如果使用AJP连接器（常见于Nginx反向代理），也需要设置`URIEncoding="UTF-8"`，如果使用了`useBodyEncodingForURI="true"`，确保请求体编码与页面一致，如果仍然乱码，可能是请求通过GET方式发送且未对URL进行编码，建议在前端对参数进行`encodeURIComponent`。
问：Tomcat控制台输出中文乱码，但网页正常，怎么办？
答：这是Tomcat自身日志输出的编码问题，与网页乱码无关，修改`conf/logging.properties`中的`java.util.logging.ConsoleHandler.encoding`为UTF-8，并确保系统环境变量`JAVA_TOOL_OPTIONS`或`CATALINA_OPTS`中设置了`-Dfile.encoding=UTF-8`，重启后控制台日志即可正常显示中文。
问：网页乱码是Tomcat还是浏览器问题，如何快速定位？
答：在浏览器中按下F12，查看网络请求的响应头，Content-Type`中包含`charset=UTF-8`，但页面仍乱码，则问题在Tomcat之前的代理或负载均衡器（如Nginx）未正确传递编码，如果响应头没有`charset`，说明Tomcat没有在响应中设置编码，应检查过滤器或页面声明，在浏览器中手动切换编码，如果切换后乱码消失，则确认是Tomcat未通知浏览器编码。