CentOS Java日志为何乱码

CentOS 上 Java 日志出现乱码，通常不是 Java 本身的问题，而是字符编码不一致导致的。下面按最常见原因 → 排查方法 → 解决方案给你一个完整说明。

一、最常见原因（90% 都在这里）

1️⃣ Linux 系统字符集不是 UTF-8

CentOS 默认有时是：

LANG=en_US

或

LANG=C

这会导致：

Java 默认使用 ISO-8859-1
中文日志变成 ????? 或 ç

✅ 检查系统编码

locale

如果看到：

LANG=C

或没有 UTF-8，就是问题根源。

2️⃣ Java 启动参数未指定 UTF-8

即使系统是 UTF-8，Java 也可能用错误编码。

✅ 检查 Java 默认编码

java -XshowSettings:properties -version 2>&1 | grep file.encoding

如果不是：

file.encoding = UTF-8

就会乱码。

3️⃣ 日志框架未指定编码（Logback / Log4j2）

Logback 示例（常见坑）

<encoder>
    <pattern>%d %msg%n</pattern>
</encoder>

❌ 没指定 charset，默认可能用系统编码

✅ 正确写法：

<encoder>
    <pattern>%d %msg%n</pattern>
    <charset>UTF-8</charset>
</encoder>

4️⃣ 终端 / SSH 工具编码不一致

即使日志是对的，你看到的是乱码。

常见情况：

Xshell / SecureCRT
Docker exec
kubectl logs

✅ 确保终端编码：

UTF-8
不要 GBK

5️⃣ 文件本身是 UTF-8，但被当成 GBK 打开

例如：

tail / cat 正常
less 乱码
vim 乱码

✅ 用 vim 查看：

:set fileencoding

二、快速排查步骤（推荐顺序）

✅ Step 1：确认系统编码

locale

✅ 建议结果：

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

✅ Step 2：确认 Java 编码

java -XshowSettings:properties -version

重点看：

file.encoding = UTF-8

✅ Step 3：确认日志文件编码

file app.log

✅ 正确：

app.log: UTF-8 Unicode text

三、标准解决方案（直接照做）

✅ 方案一（最推荐）：系统级修复

vim /etc/locale.conf

改成：

LANG=en_US.UTF-8

然后：

source /etc/locale.conf

✅ 方案二：Java 启动参数（强烈建议）

java \
-Dfile.encoding=UTF-8 \
-Dsun.jnu.encoding=UTF-8 \
-jar app.jar

✅ 这是生产环境标准做法

✅ 方案三：日志框架显式 UTF-8

Log4j2

<PatternLayout charset="UTF-8" pattern="%d %msg%n"/>

Logback（前面已给）

四、Docker / Kubernetes 特别注意

Dockerfile

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

Kubernetes

env:
- name: LANG
  value: en_US.UTF-8
- name: LC_ALL
  value: en_US.UTF-8

五、一句话总结

CentOS Java 日志乱码 = 编码不一致
✅ 系统 UTF-8
✅ Java -Dfile.encoding=UTF-8
✅ 日志框架显式 UTF-8
✅ 终端 UTF-8

如果你愿意，可以把下面信息发我，我可以精准定位是哪一层的问题：

locale 输出
Java 版本
日志框架（logback / log4j2）
乱码截图或示例字符