tomcat日志中文乱码问题及解决方案

Tomcat日志中文乱码是一个常见问题，通常是由字符编码不一致引起的。以下是常见原因和解决方案：

一、常见乱码场景

1. 控制台输出乱码

• 启动时catalina.out或控制台中文显示为???或乱码字符
• 访问日志localhost_access_log中的中文参数乱码

2. 日志文件乱码

• Log4j/Logback等日志框架输出的中文乱码
• 应用自身使用System.out.println()输出的中文乱码

二、主要原因分析

三、解决方案

方案1：修改Tomcat启动脚本（推荐）

Linux/Unix系统 (catalina.sh)：

# 在文件开头添加或修改
JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8"
# 或
export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8"

Windows系统 (catalina.bat)：

# 在setlocal后添加
set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"

方案2：修改JVM参数

在setenv.sh或setenv.bat中添加：

export JAVA_OPTS="$JAVA_OPTS -Dfile.encoding=UTF-8 -Dsun.jnu.encoding=UTF-8"

方案3：修改server.xml中的访问日志编码

<Valve className="org.apache.catalina.valves.AccessLogValve"
       directory="logs"
       prefix="localhost_access_log"
       suffix=".txt"
       pattern="%h %l %u %t &quot;%r&quot; %s %b"
       fileEncoding="UTF-8" />  <!-- 添加这一行 -->

方案4：修改logging.properties（Tomcat 8+）

在conf/logging.properties中：

java.util.logging.ConsoleHandler.encoding = UTF-8
java.util.logging.FileHandler.encoding = UTF-8

方案5：Linux系统环境变量设置

在~/.bashrc或/etc/profile中添加：

export LANG="en_US.UTF-8"
export LC_ALL="en_US.UTF-8"

方案6：应用级别设置

在Spring Boot项目中，application.properties：

server.tomcat.uri-encoding=UTF-8
server.servlet.encoding.charset=UTF-8
server.servlet.encoding.force=true

四、针对不同操作系统的额外配置

Windows系统：

# 修改注册表或使用chcp命令
chcp 65001  # 设置控制台为UTF-8

# 或修改注册表：
# HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\AutoRun
# 值为 "chcp 65001 > nul"

Docker容器：

ENV LANG C.UTF-8
ENV LC_ALL C.UTF-8

五、排查步骤

检查当前编码：

System.out.println("file.encoding=" + System.getProperty("file.encoding"));
System.out.println("Default Charset=" + Charset.defaultCharset());

检查日志配置：

• 确认日志框架（Log4j2/Logback）编码设置
• 检查日志文件实际编码格式（使用file -i或Notepad++查看）

统一编码策略：

• JVM参数：-Dfile.encoding=UTF-8
• 数据库连接：characterEncoding=utf8
• HTTP请求/响应：设置UTF-8

六、最佳实践建议

七、快速测试

创建测试JSP文件test-encoding.jsp：

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page import="java.nio.charset.Charset" %>
<%
  out.println("JVM file.encoding: " + System.getProperty("file.encoding") + "<br>");
  out.println("Default Charset: " + Charset.defaultCharset() + "<br>");
  out.println("中文测试");
%>

访问该页面，确认中文显示正常。