Java logback框架日志输出中文乱码的解决方案(windows)

在Java开发中，日志记录是一个重要的部分，它可以帮我们定位问题、运行时监控、错误排查与故障恢复。但是，在有些情况下，使用Logback记录的中文日志会出现乱码，这会影响日志的可读性，给维护带来麻烦。本文将探讨如何解决这个问题。

一 中文乱码原因分析
日志输出的中文乱码通常是由于字符编码不匹配导致的。在Java中，字符串的默认编码是UTF-8，而在某些日志框架中，默认的编码可能是ISO-8859-1。这就会导致在写入中文日志时，出现乱码。

二 解决方案

1. 检查IDEA的编码设置
   首先，确保IDEA的编码设置正确。IDEA的编码设置会影响控制台的输出编码。

打开IDEA，点击 File -> Settings（Windows）。
在设置窗口中，找到 Editor -> File Encodings。
确保 Global Encoding、Project Encoding 和 Default encoding for properties files 都设置为 UTF-8。见下图：

2 配置Logback的编码

修改Logback的配置文件，以确保输出中文的编码设置正确。保证console，file_info，file_error三处都有<charset>UTF-8</charset>配置。见下：

	<?xml version="1.0" encoding="UTF-8"?>
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!-- 日志存放路径 -->
	<property name="log.path" value="logs/dpm-mquartz" />
   <!-- 日志输出格式 -->
	<property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n"/>

    <!-- 控制台输出 -->
	<appender name="console" class="ch.qos.logback.core.ConsoleAppender">
		<encoder>
			<pattern>${log.pattern}</pattern>
            <!-- 设置编码为 UTF-8 -->
            <charset>UTF-8</charset>
		</encoder>
	</appender>

    <!-- 系统日志输出 -->
	<appender name="file_info" class="ch.qos.logback.core.rolling.RollingFileAppender">
	    <file>${log.path}/info.log</file>
        <!-- 循环政策：基于时间创建日志文件 -->
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志文件名格式 -->
			<fileNamePattern>${log.path}/info.%d{yyyy-MM-dd}.log</fileNamePattern>
			<!-- 日志最大的历史 60天 -->
			<maxHistory>60</maxHistory>
		</rollingPolicy>
		<encoder>
			<pattern>${log.pattern}</pattern>
            <!-- 设置编码为 UTF-8 -->
            <charset>UTF-8</charset>
		</encoder>
		<filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 过滤的级别 -->
            <level>INFO</level>
            <!-- 匹配时的操作：接收（记录） -->
            <onMatch>ACCEPT</onMatch>
            <!-- 不匹配时的操作：拒绝（不记录） -->
            <onMismatch>DENY</onMismatch>
        </filter>
	</appender>

    <appender name="file_error" class="ch.qos.logback.core.rolling.RollingFileAppender">
	    <file>${log.path}/error.log</file>
        <!-- 循环政策：基于时间创建日志文件 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志文件名格式 -->
            <fileNamePattern>${log.path}/error.%d{yyyy-MM-dd}.log</fileNamePattern>
			<!-- 日志最大的历史 60天 -->
			<maxHistory>60</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>${log.pattern}</pattern>
            <!-- 设置编码为 UTF-8 -->
            <charset>UTF-8</charset>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 过滤的级别 -->
            <level>ERROR</level>
			<!-- 匹配时的操作：接收（记录） -->
            <onMatch>ACCEPT</onMatch>
			<!-- 不匹配时的操作：拒绝（不记录） -->
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <!-- 系统模块日志级别控制  -->
	<logger name="com.dpm" level="info" />
	<!-- Spring日志级别控制  -->
	<logger name="org.springframework" level="warn" />

	<root level="info">
		<appender-ref ref="console" />
	</root>
	
	<!--系统操作日志-->
    <root level="info">
        <appender-ref ref="file_info" />
        <appender-ref ref="file_error" />
    </root>
</configuration>

3 在批处理文件中设置JVM 参数

在启动Java应用时，通过设置JVM参数来确保整个应用运行在UTF-8编码下。可以在命令行中使用以下参数：

 -Dfile.encoding=UTF-8 

4 在批处理文件中输入chcp 65001

chcp 65001

举例： bat 文件实例

@echo off
chcp 65001
echo.
echo [info] run project name Project
echo.

cd %~dp0

set JAVA_OPTS=-Xms512m -Xmx1024m -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=512m

java -Dfile.encoding=utf-8 -jar %JAVA_OPTS%  project_name.jar

cd bin
pause