skywalking整合logback.xml日志，日志文件出现乱码问题解决

galaxyffang2025-11-20 13:42

存在问题及解决方案

存在的问题：日志文件中的日志信息存在乱码问题

解决方案：修改logback.xml日志文件配置

1.排查skywalking相关依赖项是否有问题

相关依赖都正确引入

logback.xml文件配置如下：

xml 复制代码 
<configuration>
    <!-- 引用 Spring Boot 的 logback 基础配置 -->
    <include resource="org/springframework/boot/logging/logback/defaults.xml" />
    <!-- 变量 llwallet.info.base-package，基础业务包 -->
    <springProperty scope="context" name="llwallet.info.base-package" source="llwallet.info.base-package"/>
    <!-- 格式化输出：%d 表示日期，%X{tid} SkWalking 链路追踪编号，%thread 表示线程名，%-5level：级别从左显示 5 个字符宽度，%msg：日志消息，%n是换行符 -->
    <property name="PATTERN_DEFAULT" value="%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} %highlight(${LOG_LEVEL_PATTERN:-%5p}) %boldYellow([%tid]) %boldGreen(%logger{5}) %m%n"/>

    <!-- 日志文件目录 -->
    <property name="basedir" value="/usr/log/applog"/>

    <!-- 控制台 Appender -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                <pattern>${PATTERN_DEFAULT}</pattern>
            </layout>
        </encoder>
    </appender>

    <!-- 文件 Appender -->
    <!-- 参考 Spring Boot 的 file-appender.xml 编写 -->
    <appender name="FILE"  class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                <pattern>${PATTERN_DEFAULT}</pattern>
            </layout>
        </encoder>
        <!-- 日志文件名 -->
        <file>${basedir}/llwallet-mng-server.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后的日志文件名 -->
            <fileNamePattern>${LOGBACK_ROLLINGPOLICY_FILE_NAME_PATTERN:-${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz}</fileNamePattern>
            <!-- 启动服务时，是否清理历史日志，一般不建议清理 -->
            <cleanHistoryOnStart>${LOGBACK_ROLLINGPOLICY_CLEAN_HISTORY_ON_START:-false}</cleanHistoryOnStart>
            <!-- 日志文件，到达多少容量，进行滚动 -->
            <maxFileSize>${LOGBACK_ROLLINGPOLICY_MAX_FILE_SIZE:-10MB}</maxFileSize>
            <!-- 日志文件的总大小，0 表示不限制 -->
            <totalSizeCap>${LOGBACK_ROLLINGPOLICY_TOTAL_SIZE_CAP:-0}</totalSizeCap>
            <!-- 日志文件的保留天数 -->
            <maxHistory>${LOGBACK_ROLLINGPOLICY_MAX_HISTORY:-30}</maxHistory>
        </rollingPolicy>
    </appender>
    <!-- 异步写入日志，提升性能 -->
    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 不丢失日志。默认的，如果队列的 80% 已满,则会丢弃 TRACT、DEBUG、INFO 级别的日志 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 更改默认的队列的深度，该值会影响性能。默认值为 256 -->
        <queueSize>256</queueSize>
        <appender-ref ref="FILE"/>
    </appender>

    <!-- SkyWalking GRPC 日志收集，实现日志中心。注意：SkyWalking 8.4.0 版本开始支持 -->
<!--    <appender name="GRPC" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                <pattern>${PATTERN_DEFAULT}</pattern>
            </layout>
        </encoder>
    </appender>-->

    <!-- 本地环境 -->
    <springProfile name="local">
        <root level="INFO">
            <appender-ref ref="STDOUT"/>
<!--            <appender-ref ref="GRPC"/> &lt;!&ndash; 本地环境下，如果不想接入 SkyWalking 日志服务，可以注释掉本行 &ndash;&gt;-->
            <appender-ref ref="ASYNC"/>  <!-- 本地环境下，如果不想打印日志，可以注释掉本行 -->
        </root>
    </springProfile>
    <!-- 其它环境 -->
    <springProfile name="dev,ewtest,test2,aly1,default,entaly,ewste">
        <root level="INFO">
            <appender-ref ref="STDOUT"/>
            <appender-ref ref="ASYNC"/>
<!--            <appender-ref ref="GRPC"/>-->
        </root>
    </springProfile>

</configuration>

2.在本地环境中整合好skywalking的启动参数

3.编写了测试controller，获取TID，发现控制台的日志能够正常显示，如下图：

输出的日志文件乱码

4.猜测日志配置文件配置有问题

发现控制台和日志输出文件都采用了如下的默认配置

xml 复制代码 
<!-- 控制台专用格式（带颜色高亮）：%d{yyyy-MM-dd HH:mm:ss.SSS} - 时间戳  %highlight(%-5p) - 日志级别，带颜色高亮（INFO绿色，WARN黄色，ERROR红色等）  %boldYellow([%tid]) - Trace ID，粗体黄色显示  [%F:%L]- 源代码文件名:行号  %m - 日志消息内容  %n - 换行符  -->
<property name="PATTERN_CONSOLE" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5p) %boldYellow([%tid]) [%F:%L] %m%n"/>

<!--文件输出格式（无颜色，避免乱码）：-->
<property name="PATTERN_FILE" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p [%tid] [%F:%L] %m%n"/>

问题在于控制台能够正确显示字体颜色，日志文件显示不了

5.修改配置文件。控制台日志输出显示颜色，日志文件不显示颜色

新增日志模式，修改对应模式设置

xml 复制代码 
<configuration>
    <!-- 引用 Spring Boot 的 logback 基础配置 -->
    <include resource="org/springframework/boot/logging/logback/defaults.xml" />
    <!-- 变量 llwallet.info.base-package，基础业务包 -->
    <springProperty scope="context" name="llwallet.info.base-package" source="llwallet.info.base-package"/>
    <!-- 格式化输出：%d 表示日期，%X{tid} SkWalking 链路追踪编号，%thread 表示线程名，%-5level：级别从左显示 5 个字符宽度，%msg：日志消息，%n是换行符 -->
    <property name="PATTERN_DEFAULT" value="%d{${LOG_DATEFORMAT_PATTERN:-yyyy-MM-dd HH:mm:ss.SSS}} %highlight(${LOG_LEVEL_PATTERN:-%5p}) %boldYellow([%tid]) %boldGreen(%logger{5}) %m%n"/>

    <!-- 控制台专用格式（带颜色高亮）：%d{yyyy-MM-dd HH:mm:ss.SSS} - 时间戳  %highlight(%-5p) - 日志级别，带颜色高亮（INFO绿色，WARN黄色，ERROR红色等）  %boldYellow([%tid]) - Trace ID，粗体黄色显示  [%F:%L]- 源代码文件名:行号  %m - 日志消息内容  %n - 换行符  -->
    <property name="PATTERN_CONSOLE" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5p) %boldYellow([%tid]) [%F:%L] %m%n"/>

    <!--文件输出格式（无颜色，避免乱码）：-->
    <property name="PATTERN_FILE" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %-5p [%tid] [%F:%L] %m%n"/>

    <!-- 日志文件目录 -->
    <property name="basedir" value="/usr/log/applog"/>

    <!-- 控制台 Appender -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                <pattern>${PATTERN_CONSOLE}</pattern>
            </layout>
        </encoder>
    </appender>

    <!-- 文件 Appender -->
    <!-- 参考 Spring Boot 的 file-appender.xml 编写 -->
    <appender name="FILE"  class="ch.qos.logback.core.rolling.RollingFileAppender">
        <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
            <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                <pattern>${PATTERN_FILE}</pattern>
            </layout>
        </encoder>
        <!-- 日志文件名 -->
        <file>${basedir}/llwallet-mng-server.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <!-- 滚动后的日志文件名 -->
            <fileNamePattern>${LOGBACK_ROLLINGPOLICY_FILE_NAME_PATTERN:-${LOG_FILE}.%d{yyyy-MM-dd}.%i.gz}</fileNamePattern>
            <!-- 启动服务时，是否清理历史日志，一般不建议清理 -->
            <cleanHistoryOnStart>${LOGBACK_ROLLINGPOLICY_CLEAN_HISTORY_ON_START:-false}</cleanHistoryOnStart>
            <!-- 日志文件，到达多少容量，进行滚动 -->
            <maxFileSize>${LOGBACK_ROLLINGPOLICY_MAX_FILE_SIZE:-10MB}</maxFileSize>
            <!-- 日志文件的总大小，0 表示不限制 -->
            <totalSizeCap>${LOGBACK_ROLLINGPOLICY_TOTAL_SIZE_CAP:-0}</totalSizeCap>
            <!-- 日志文件的保留天数 -->
            <maxHistory>${LOGBACK_ROLLINGPOLICY_MAX_HISTORY:-30}</maxHistory>
        </rollingPolicy>
    </appender>
    <!-- 异步写入日志，提升性能 -->
    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 不丢失日志。默认的，如果队列的 80% 已满,则会丢弃 TRACT、DEBUG、INFO 级别的日志 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 更改默认的队列的深度，该值会影响性能。默认值为 256 -->
        <queueSize>256</queueSize>
        <appender-ref ref="FILE"/>
    </appender>

    <!-- SkyWalking GRPC 日志收集，实现日志中心。注意：SkyWalking 8.4.0 版本开始支持 -->
    <!--    <appender name="GRPC" class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.log.GRPCLogClientAppender">
            <encoder class="ch.qos.logback.core.encoder.LayoutWrappingEncoder">
                <layout class="org.apache.skywalking.apm.toolkit.log.logback.v1.x.TraceIdPatternLogbackLayout">
                    <pattern>${PATTERN_DEFAULT}</pattern>
                </layout>
            </encoder>
        </appender>-->

    <!-- 本地环境 -->
    <springProfile name="local">
        <root level="INFO">
            <appender-ref ref="STDOUT"/>
            <!--            <appender-ref ref="GRPC"/> &lt;!&ndash; 本地环境下，如果不想接入 SkyWalking 日志服务，可以注释掉本行 &ndash;&gt;-->
            <appender-ref ref="ASYNC"/>  <!-- 本地环境下，如果不想打印日志，可以注释掉本行 -->
        </root>
    </springProfile>
    <!-- 其它环境 -->
    <springProfile name="dev,ewtest,test2,aly1,default,entaly,ewste">
        <root level="INFO">
            <appender-ref ref="STDOUT"/>
            <appender-ref ref="ASYNC"/>
            <!--            <appender-ref ref="GRPC"/>-->
        </root>
    </springProfile>

</configuration>

7.重启服务，验证日志输出是否正确

相关推荐
q***48257 小时前
Skywalking介绍，Skywalking 9.4 安装，SpringBoot集成Skywalking
spring boot·后端·skywalking
q***18841 天前
Spring Boot 3.3.4 升级导致 Logback 之前回滚策略配置不兼容问题解决
java·spring boot·logback
j***29481 天前
【SpringBoot】【log】 自定义logback日志配置
java·spring boot·logback
s***55811 天前
Skywalking介绍，Skywalking 9.4 安装，SpringBoot集成Skywalking
spring boot·后端·skywalking
百***26631 天前
使用 Logback 的最佳实践：`logback.xml` 与 `logback-spring.xml` 的区别与用法
xml·spring·logback
q***84571 天前
分布式监控Skywalking安装及使用教程（保姆级教程）
分布式·skywalking
864记忆1 天前
Qt 对 JSON和XML文件的操作详解
xml·qt·json
a***97682 天前
使用 Logback 的最佳实践：`logback.xml` 与 `logback-spring.xml` 的区别与用法
xml·spring·logback
galaxyffang2 天前
skywalking中TID
skywalking
热门推荐
01GitHub 镜像站点02今天 Cloudflare 全球事故，连 GPT 和你的网站都一起“掉线”了03UV安装并设置国内源04安娜的档案(Anna’s Archive) 镜像网站/国内最新可访问入口（持续更新）05Linux下V2Ray安装配置指南06BongoCat - 跨平台键盘猫动画工具07全球最强模型Grok4，国内已可免费使用！（附教程）08Valdi：Snapchat 开源的新一代跨平台 UI 框架09Labelme从安装到标注：零基础完整指南10swagger xss漏洞复现