如何解決centos tomcat日志亂碼問題

解決CentOS下Tomcat日志亂碼問題的完整步驟

Tomcat日志亂碼的本質是字符編碼不一致（JVM輸出編碼、系統環境編碼、終端顯示編碼、日志處理器編碼未統一為UTF-8）。以下是針對性解決步驟，按優先級排序：

1. 修改Tomcat啟動腳本（關鍵：設置JVM字符集參數）

Tomcat的啟動腳本（catalina.sh）需顯式指定JVM的字符編碼為UTF-8，確保應用輸出、日志寫入的一致性。

• 打開$CATALINA_HOME/bin/catalina.sh（$CATALINA_HOME為Tomcat安裝目錄）；
• 在文件開頭（#!/bin/sh之后）添加以下內容：

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

  注：-Dfile.encoding控制JVM默認字符編碼，-Dsun.jnu.encoding控制文件系統操作的編碼（如日志文件寫入），兩者均需設置為UTF-8。

2. 調整日志處理器編碼（解決控制臺/文件日志亂碼）

Tomcat的日志處理器（如ConsoleHandler）默認編碼可能為ISO-8859-1，需修改logging.properties文件強制使用UTF-8。

• 打開$CATALINA_HOME/conf/logging.properties；
• 找到以下兩行（或類似配置），將編碼修改為UTF-8：

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

  注：若日志通過log4j或logback輸出，需修改對應配置文件（如log4j.properties中的log4j.appender.CONSOLE.Encoding=utf-8）。

3. 檢查并設置系統環境變量（確保系統編碼一致）

CentOS系統的默認語言環境（LANG）需設置為UTF-8，避免終端或系統工具（如cat）顯示亂碼。

• 查看當前系統編碼：

  echo $LANG
  

  若輸出不是zh_CN.UTF-8或en_US.UTF-8，需修改系統配置：
• 編輯/etc/profile文件，添加以下內容：

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

• 使配置生效：

  source /etc/profile
  

  注：可通過locale命令驗證所有環境變量是否為UTF-8。

4. 驗證終端工具編碼（避免顯示端亂碼）

若使用SSH工具（如PuTTY、Xshell）連接CentOS，需確保終端工具的字符編碼設置為UTF-8：

• PuTTY：Connection -> Data -> Terminal-type string設置為xterm-256color，Window -> Translation -> Remote character set設置為UTF-8；
• Xshell：文件 -> 屬性 -> 終端 -> 編碼設置為UTF-8。

5. 處理日志切割工具（避免切割后亂碼）

若使用logrotate或cronolog切割日志，需確保切割命令不會破壞文件編碼（如避免用>重定向清空文件，推薦用truncate）：

• 示例切割腳本（保留UTF-8編碼）：

  cp $CATALINA_HOME/logs/catalina.out $CATALINA_HOME/logs/catalina.out.$(date +%Y-%m-%d)
  truncate -s 0 $CATALINA_HOME/logs/catalina.out
  

6. 檢查應用程序自身編碼（排除應用層問題）

若應用輸出的日志本身包含亂碼（如從數據庫讀取或文件讀取時未指定編碼），需修改應用代碼：

• Java代碼中顯式指定編碼（如OutputStreamWriter）：

  import java.io.OutputStreamWriter;
  import java.io.PrintWriter;
  public class LogWriter {
      public static void main(String[] args) {
          try (PrintWriter out = new PrintWriter(new OutputStreamWriter(System.out, "UTF-8"))) {
              out.println("中文測試");
          } catch (Exception e) {
              e.printStackTrace();
          }
      }
  }
  

• 若使用log4j/logback，確保appender的encoding設置為UTF-8。

完成以上步驟后，重啟Tomcat服務使配置生效：

$CATALINA_HOME/bin/shutdown.sh && $CATALINA_HOME/bin/startup.sh

通過以上步驟，可徹底解決CentOS下Tomcat日志亂碼問題。若仍存在亂碼，建議檢查日志內容的具體編碼（用file -i catalina.out命令），確認是否與配置一致。