Ubuntu下Tomcat日志亂碼怎么辦

Ubuntu下Tomcat日志亂碼解決方法

1. 檢查并統一系統默認編碼

Ubuntu系統的默認編碼需與Tomcat日志編碼一致（推薦UTF-8）。通過以下命令查看當前系統編碼：

locale

若未設置為UTF-8，可通過修改/etc/default/locale文件（需root權限）添加以下內容：

LANG=en_US.UTF-8
LANGUAGE=en_US.UTF-8
LC_ALL=en_US.UTF-8

保存后執行source /etc/default/locale使設置生效。

2. 修改Tomcat的JVM啟動參數（關鍵步驟）

Tomcat的JVM需明確指定日志編碼為UTF-8。編輯Tomcat的bin/catalina.sh文件（Ubuntu下路徑通常為/opt/tomcat/bin/catalina.sh或/var/lib/tomcat9/bin/catalina.sh），在JAVA_OPTS變量中添加以下參數：

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

保存后重啟Tomcat使配置生效：

sudo systemctl restart tomcat

此步驟可解決大部分JVM層面輸出的日志亂碼問題。

3. 調整Tomcat日志配置文件（logging.properties）

Tomcat的日志處理器（如控制臺輸出）需單獨設置編碼。打開conf/logging.properties文件，找到java.util.logging.ConsoleHandler.encoding配置項，將其值修改為UTF-8：

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

若日志仍亂碼，可嘗試將其他Handler（如FileHandler）的編碼也設置為UTF-8，例如：

1catalina.org.apache.juli.FileHandler.encoding = UTF-8
2localhost.org.apache.juli.FileHandler.encoding = UTF-8

修改后重啟Tomcat。

4. 配置Tomcat Connector的URIEncoding

若日志中包含URL參數或請求路徑的亂碼（如中文參數），需修改conf/server.xml文件中的Connector配置，添加URIEncoding="UTF-8"屬性：

<Connector port="8080" protocol="HTTP/1.1"
           connectionTimeout="20000"
           redirectPort="8443"
           URIEncoding="UTF-8" />

此配置確保Tomcat正確解析URL中的非ASCII字符，避免日志中URL亂碼。

5. 檢查第三方日志框架配置（如Log4j/Logback）

若項目使用了Log4j或Logback等第三方日志框架，需額外配置其編碼。例如：

• Log4j：在log4j.properties中添加log4j.appender.stdout.encoding=UTF-8；
• Logback：在logback.xml中為<appender>添加<encoder>配置，指定charset="UTF-8"。
  修改后重啟Tomcat使框架配置生效。

注意事項

• 若日志文件已存在亂碼，需用iconv工具轉換編碼（如將GBK轉為UTF-8）：

  iconv -f GBK -t UTF-8 catalina.out -o catalina_utf8.out
  

• 確保編輯配置文件時使用支持UTF-8的文本編輯器（如nano、vim），并保存為UTF-8格式。

通過以上步驟，可徹底解決Ubuntu下Tomcat日志亂碼問題。