log4j中文日志乱码问号-Linux启动jar包，输出中文日志变成问号？

文章目录

问题现象

在Linux服务器上启动Java JAR包应用后，查看日志文件（如app.log）或通过控制台输出时，发现所有中文字符都显示为问号（???）或乱码。

例如，期望的日志：
[INFO] 用户登录成功，用户名：张三

实际看到的日志：
[INFO] ??????????，??????：???

根本原因

这个问题的核心是字符编码不一致。具体来说，是Java应用在写入日志时使用的字符编码，与操作系统、终端或日志查看工具读取日志时使用的字符编码不匹配。

在Linux环境下，最常见的原因是：

JVM默认编码 ：Java虚拟机（JVM）在启动时，如果没有明确指定，会使用操作系统的默认编码。某些Linux发行版或配置可能默认使用ANSI_X3.4-1968（即ASCII）或其他不支持中文的编码。
日志框架配置：日志框架（如Log4j, Logback）在配置输出（Appender）时，如果没有指定编码，会使用JVM的默认编码来写入文件。
终端/查看器编码 ：当你使用cat、tail命令或文本编辑器查看日志文件时，这些工具也会使用一个默认编码来解析文件内容。如果这个编码与日志文件实际写入的编码不一致，就会出现乱码。

解决方案

解决此问题需要从"写入"和"读取"两个环节入手，确保整个链路的编码统一为UTF-8。

方案一：在启动命令中强制指定JVM编码（推荐）

这是最直接、最有效的方法。通过在java启动命令中添加-Dfile.encoding=UTF-8参数，强制JVM使用UTF-8编码。

修改前：

bash 复制代码

java -jar your-application.jar
# 或使用nohup后台启动
nohup java -jar your-application.jar > app.log 2>&1 &

修改后：

bash 复制代码

java -Dfile.encoding=UTF-8 -jar your-application.jar
# 或使用nohup后台启动
nohup java -Dfile.encoding=UTF-8 -jar your-application.jar > app.log 2>&1 &

这个参数会告诉JVM，所有与文件、字符串相关的I/O操作都默认使用UTF-8编码。这通常能解决90%以上的乱码问题。

补充说明 ：在某些特殊情况下，可能还需要添加-Dsun.jnu.encoding=UTF-8参数，以确保文件名等系统相关操作的编码也是UTF-8。

验证JVM编码 ：

你可以在应用的main方法开头添加以下代码来验证JVM的编码设置是否生效：

java 复制代码

System.out.println("当前JVM文件编码: " + System.getProperty("file.encoding"));
// 期望输出: 当前JVM文件编码: UTF-8

方案二：在日志框架配置中指定编码

如果方案一无效，或者你想在应用层面进行更精细的控制，可以在日志框架的配置文件中显式指定输出编码。

Log4j 1.x (log4j.properties)

在文件Appender的配置中加入Encoding属性。

properties 复制代码

# 定义一个文件输出源
log4j.appender.file=org.apache.log4j.RollingFileAppender
log4j.appender.file.File=app.log
# 【关键】指定文件编码为UTF-8
log4j.appender.file.Encoding=UTF-8
log4j.appender.file.layout=org.apache.log4j.PatternLayout
log4j.appender.file.layout.ConversionPattern=%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n

Log4j 2.x (log4j2.xml)

在<File>或<Console> Appender的<PatternLayout>标签中设置charset属性。

xml 复制代码

<Configuration status="WARN">
  <Appenders>
    <File name="FileAppender" fileName="logs/app.log" append="true">
      <!-- 【关键】指定布局的字符集为UTF-8 -->
      <PatternLayout charset="UTF-8" pattern="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n"/>
    </File>
  </Appenders>
  <Loggers>
    <Root level="info">
      <AppenderRef ref="FileAppender"/>
    </Root>
  </Loggers>
</Configuration>

Logback (logback.xml)

在<encoder>标签内使用<charset>标签。

xml 复制代码

<configuration>
  <appender name="FILE" class="ch.qos.logback.core.FileAppender">
    <file>app.log</file>
    <encoder>
      <!-- 【关键】指定编码器字符集为UTF-8 -->
      <charset>UTF-8</charset>
      <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
  </appender>
  <root level="INFO">
    <appender-ref ref="FILE" />
  </root>
</configuration>

方案三：检查并设置Linux系统环境变量

确保你的Linux服务器本身支持并默认使用UTF-8编码。

查看当前系统语言环境：
bash 复制代码
```
locale
```
检查输出中LANG和LC_*相关变量的值。理想情况下，它们应该包含.UTF-8，例如en_US.UTF-8或zh_CN.UTF-8。
临时设置（当前会话有效）：
bash 复制代码
```
export LANG=en_US.UTF-8
export LC_ALL=en_US.UTF-8
```
永久设置 ：

这取决于你的Linux发行版。通常可以通过修改/etc/locale.conf或/etc/default/locale文件来实现。
bash 复制代码
```
# 例如，编辑 /etc/locale.conf
sudo vi /etc/locale.conf
# 添加或修改为以下内容
LANG=en_US.UTF-8
LC_ALL=en_US.UTF-8
```
修改后需要重新登录或重启服务器才能生效。

排查流程总结

当遇到日志乱码问题时，建议按照以下步骤进行排查：

首选：在Java启动命令中添加-Dfile.encoding=UTF-8参数，重启应用。
其次：检查你的日志框架配置文件（log4j.properties、logback.xml等），确保文件输出Appender已明确配置了UTF-8编码。
再次：使用locale命令检查Linux服务器的系统编码环境，并确保其支持UTF-8。
最后：当你使用文本编辑器查看日志文件时，确保编辑器也是用UTF-8编码打开的。

通过以上方法，基本可以彻底解决Linux环境下Java应用日志中文乱码的问题。