0

0

Tomcat控制台输出中文乱码怎么解决_logging.properties编码修改

P粉602998670

P粉602998670

发布时间:2026-03-17 14:40:30

|

587人浏览过

|

来源于php中文网

原创

Tomcat 控制台中文乱码需同步解决三方面:logging.properties 文件须UTF-8无BOM保存并删中文注释;JVM启动参数加-Dfile.encoding=UTF-8且ConsoleHandler显式设encoding=UT-8;终端(如Windows CMD)须支持UTF-8输出,或改用PowerShell/IDE Terminal。

tomcat控制台输出中文乱码怎么解决_logging.properties编码修改

logging.properties 文件本身需要 UTF-8 编码保存

Tomcat 的 logging.properties 是 Java Util Logging(JUL)的配置文件,它本身不声明编码,但 JVM 读取时默认按平台编码(Windows 上通常是 GBK)解析。如果你用编辑器以 UTF-8 保存却含中文注释或日志格式字符串,JVM 可能读错字节,导致控制台输出乱码——不是日志内容乱,而是配置里写的中文根本没被正确识别。

实操建议:

  • 用 VS Code、Notepad++ 或 IntelliJ 打开 $CATALINA_BASE/conf/logging.properties,确认右下角显示「UTF-8」编码,不是「GBK」或「UTF-8 with BOM」
  • 删掉所有中文注释(哪怕只是「# 日志级别」),改用英文;中文真正起作用的是 java.util.logging.ConsoleHandler.formatter 指定的 formatter 输出内容,不是配置文件里的注释
  • 如果必须在配置中写中文(比如自定义 java.util.logging.SimpleFormatter.format 模板),确保该行是纯 UTF-8 字节流,且无 BOM —— 有些编辑器默认加 BOM,会导致 JUL 解析失败

ConsoleHandler 默认用平台编码输出,需显式指定 UTF-8

JVM 启动时,ConsoleHandler 底层用 System.out 写日志,而 System.out 的编码由系统属性 file.encoding 和终端环境共同决定。即使 logging.properties 是 UTF-8,控制台仍可能用 GBK 渲染,尤其 Windows CMD/PowerShell 默认不支持 UTF-8 输出流。

实操建议:

  • logging.properties 中添加:
    java.util.logging.ConsoleHandler.encoding = UTF-8
  • 同时确保启动 Tomcat 时 JVM 参数包含:-Dfile.encoding=UTF-8(加在 catalina.shcatalina.batJAVA_OPTS 里)
  • Windows 用户注意:CMD 默认代码页是 936(GBK),即使 JVM 用了 UTF-8,CMD 也无法正常显示。要么改用 PowerShell 并执行 chcp 65001,要么直接用 IDE(如 IDEA)的 Terminal,它默认支持 UTF-8

log4j2 或 slf4j 桥接场景下,logging.properties 不生效

很多项目实际用的是 log4j2slf4j + logback,它们会屏蔽 JUL 的 logging.properties,此时改这个文件完全无效。你看到的“Tomcat 控制台乱码”,其实可能是应用日志框架输出的,和 Tomcat 自身日志无关。

Picsart AI Image Generator
Picsart AI Image Generator

Picsart推出的AI图片生成器

下载

实操建议:

  • 检查 WEB-INF/lib/ 下是否有 log4j-to-slf4j-*.jarslf4j-jdk14-*.jar 等桥接包 —— 有就说明 JUL 被接管了
  • 确认乱码内容来源:如果是 org.apache.catalina.core.StandardContext.startInternal 这类 Tomcat 自身日志,才看 logging.properties;如果是 com.example.MyServlet 输出的,就得去查应用自己的日志配置(如 log4j2.xmlConsoleAppender 编码设置)
  • 临时验证方法:停掉应用,只启动 Tomcat 空实例,看 startup.log 或控制台是否仍有乱码 —— 没有,说明问题出在应用层

IDE 启动 Tomcat 时,终端编码常被 IDE 自行覆盖

IntelliJ / Eclipse 启动 Tomcat 时,不会读取系统 catalina.bat/sh 的 JVM 参数,而是用自己的运行配置。即使你在 catalina.bat 加了 -Dfile.encoding=UTF-8,IDE 也大概率忽略它。

实操建议:

  • IntelliJ:打开 Run → Edit Configurations → 选中 Tomcat Server → Environment → VM Options,手动加上 -Dfile.encoding=UTF-8
  • 同时勾选「Add VM options」下方的「Include system properties from catalina.sh/bat」(新版 IntelliJ 叫「Pass environment variables」,不一定可靠,别依赖)
  • Eclipse:Server 配置 → Open launch configuration → Arguments → VM arguments 同样加 -Dfile.encoding=UTF-8
  • 别信 IDE 控制台右下角显示的「UTF-8」——那只是界面编码,不代表 JVM 输出流用了 UTF-8

Tomcat 控制台中文乱码的本质,是「JVM 读配置的编码」、「JVM 写控制台的编码」、「终端渲染的编码」三者没对齐。最容易被忽略的是:你以为在改日志配置,其实日志根本没走 JUL;或者你设了 UTF-8,但终端根本不支持。先锁定哪一层在输出乱码,再动手。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

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

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

117

2023.10.26

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

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

173

2024.02.23

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

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

99

2024.02.23

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

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

170

2024.02.23

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

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

159

2024.02.23

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

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

200

2024.02.23

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

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

245

2024.02.23

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

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

170

2024.02.23

抖漫入口地址合集
抖漫入口地址合集

本专题整合了抖漫入口地址相关合集,阅读专题下面的文章了解更多详细地址。

0

2026.03.17

热门下载

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

精品课程

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

共57课时 | 7.2万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号