讲师中心 微信公众号
AI工具推荐 视频效率加速

配置Tomcat字符集编码环境变量教程

酷明姑娘_3180

酷明姑娘_3180

发布时间:2026-09-09 19:38:03

|

294人浏览过

|

来源于php中文网

原创

Tomcat乱码问题需同时配置server.xml的URIEncoding="UTF-8"和logging.properties的ConsoleHandler.encoding=GBK;前者解决GET参数乱码,后者修复控制台日志显示,二者缺一不可,且修改后必须重启Tomcat。

配置tomcat字符集编码环境变量教程

Tomcat 启动后控制台乱码、中文请求参数变成问号或方块——根本原因不是没配 CATALINA_HOME,而是字符集配置分散在两个地方,且作用对象不同:一个管 HTTP 请求解码(URIEncoding),一个管日志输出编码(logging.properties)。只改一个,问题照旧。

server.xml 中的 URIEncoding="UTF-8" 是必须加的

这个配置决定 Tomcat 如何解析 URL 和 GET 请求里的中文参数。不加的话,request.getParameter("name") 拿到的就是乱码,哪怕页面本身显示正常。

  • 路径:conf/server.xml,找到类似这一行:
    <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"/>
  • 在该标签末尾插入 URIEncoding="UTF-8",变成:
    <Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" URIEncoding="UTF-8"/>
  • 注意:不是 URLCoding 或 URLEncoding,拼写错误会导致配置被忽略
  • 改完必须重启 Tomcat,热加载不生效

logging.properties 里要改 encoding=GBK(Windows)

Windows 控制台默认用 GBK 编码,而 Tomcat 日志组件默认用 UTF-8 输出,两者不匹配就满屏“???”。这不是 bug,是编码策略冲突。

  • 路径:conf/logging.properties
  • 找到这行:
    java.util.logging.ConsoleHandler.encoding = UTF-8
  • 改成:
    java.util.logging.ConsoleHandler.encoding = GBK
  • 如果还看到其他 .encoding = UTF-8(比如 java.util.logging.FileHandler.encoding),按需一并改掉
  • Linux/macOS 用户不用改这里,终端通常原生支持 UTF-8

别碰系统 locale 或 cmd 默认代码页

有人试图通过 chcp 65001 切换 CMD 到 UTF-8,或修改注册表改系统 locale——这会影响所有 Java 程序,且容易引发其他工具异常。Tomcat 的乱码是它自己组件的编码行为,应由它自己的配置解决,而不是动系统底层。

  • startup.bat 启动时不会继承 chcp 设置,改了也白改
  • 某些 JDK 版本(如 8u291+)对 chcp 65001 支持不稳定,反而导致 System.out 输出中断
  • 真正需要统一编码的地方只有两处:server.xml 和 logging.properties,其余都是干扰项

最常被忽略的是:改完 server.xml 后没重启,或者以为改了日志编码就能解决请求参数乱码——其实那是两个独立通道。一个管进来的数据,一个管打出来的字。漏掉任何一个,都会让你在调试时反复怀疑是不是代码写错了。

热门AI工具

更多
LibLibAI
LibLibAI Hot

一款AI视频创作工具,主要用于国内领先的AI创意平台,以海量模型、低门槛操作与“创作-分享-商业化”生态,让小白与专业创作者都能高效实现图文乃至视频创意表达,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

相关专题

更多
如何配置Tomcat环境变量
如何配置Tomcat环境变量

配置Tomcat环境变量需要在系统中添加CATALINA_HOME变量,并将Tomcat的安装路径添加到PATH变量中。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

645

2023.10.26

idea如何集成Tomcat
idea如何集成Tomcat

idea集成Tomcat的步骤:1、添加Tomcat服务器配置;2、配置项目部署;3、运行Tomcat服务器;4、访问项目;5、注意事项;6、关闭Tomcat服务器。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

284

2024.02.23

怎么查看Tomcat源代码
怎么查看Tomcat源代码

查看Tomcat源代码的步骤:1、下载Tomcat源代码;2、在IDEA中导入Tomcat源代码;3、查看源代码;4、理解Tomcat的工作原理;5、参与社区和贡献;6、注意事项;7、持续学习和更新;8、使用工具和插件。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

469

2024.02.23

常见的tomcat漏洞有哪些
常见的tomcat漏洞有哪些

常见的tomcat漏洞有:1、跨站脚本攻击;2、跨站请求伪造;3、目录遍历漏洞;4、缓冲区溢出漏洞;5、配置漏洞;6、第三方组件漏洞。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

265

2024.02.23

tomcat日志乱码怎么解决
tomcat日志乱码怎么解决

tomcat日志乱码的解决办法:1、修改tomcat的日志编码设置;2、检查ide的编码设置;3、检查操作系统的编码设置;4、使用过滤器处理日志;5、检查外部系统的编码设置;6、检查文件编码方式等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

328

2024.02.23

weblogic和tomcat有哪些区别
weblogic和tomcat有哪些区别

weblogic和tomcat的区别:1、功能;2、性能;3、规模;4、价格;5、安全性;6、配置和管理;7、社区支持;8、集成能力;9、升级和更新;10、可靠性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

329

2024.02.23

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

541

2024.02.23

tomcat启动闪退怎么解决
tomcat启动闪退怎么解决

tomcat启动闪退的解决办法:1、检查java环境;2、检查环境变量配置;3、检查端口被占用;4、检查配置文件编码;5、检查启动时需要的配置文件;6、检查相关文件是否丢失;7、检查防火墙和杀毒软件设置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

302

2024.02.23

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

120

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Tomcat核心原理解析
Tomcat核心原理解析

共57课时 | 8.7万人学习

Apache Maven 官方安装指南
Apache Maven 官方安装指南

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn