【Springboot知识】Logback从1.2.x升级到1.3.x需要注意哪些点？

1. 确认依赖版本

• SLF4J 版本：Logback 1.3.x 需要 SLF4J 2.x 的支持。因此需要升级 slf4j-api 到 2.x 版本。
• 其他日志桥接器：如果项目中使用了其他日志桥接器（如 log4j-over-slf4j 或 jul-to-slf4j），也需要同步升级到与 SLF4J 2.x 兼容的版本。

示例依赖配置（Maven）：

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-api</artifactId>
    <version>2.0.7</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-core</artifactId>
    <version>1.3.0</version>
</dependency>
<dependency>
    <groupId>ch.qos.logback</groupId>
    <artifactId>logback-classic</artifactId>
    <version>1.3.0</version>
</dependency>

2. 处理 StaticLoggerBinder 的移除

• 在 Logback 1.3.x 中，org.slf4j.impl.StaticLoggerBinder 类已被移除，取而代之的是基于 Java ServiceLoader 的机制。
• 如果项目直接依赖该类（或通过某些框架间接依赖），需要调整代码以适配新的加载机制。

解决方案：

• 禁用框架的日志初始化：例如在 Spring Boot 中，可以通过设置系统属性禁用默认的日志系统：

  System.setProperty("org.springframework.boot.logging.LoggingSystem", "none");
  

• 确保正确加载 Logback：通过 ServiceLoader 加载 Logback 的实现。

3. 修改日志配置文件

• Logback 1.3.x 引入了一些新特性，同时也对旧版配置进行了调整。需要检查并更新 logback.xml 文件。
• 常见改动包括：
  • 使用新的标签或属性。
  • 移除已废弃的功能或参数。

示例 logback.xml 配置：

<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="false">
    <!-- 定义编码器 -->
    <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
        <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>

    <!-- 控制台输出 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 文件输出 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>logs/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>logs/app-%d{yyyy-MM-dd}.log</fileNamePattern>
            <maxHistory>30</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 日志级别 -->
    <root level="INFO">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="FILE" />
    </root>
</configuration>

4. 检查兼容性问题

• Spring Boot 项目：Spring Boot 默认支持 Logback 1.2.x，但对 Logback 1.3.x 的支持需要从 Spring Boot 3.x 开始。如果你使用的是 Spring Boot 2.x，则需要手动禁用默认的日志系统并引入 Logback 1.3.x。
• 其他框架：检查项目中使用的其他框架是否兼容 Logback 1.3.x。如果不兼容，可能需要升级相关框架或寻找替代方案。

Spring Boot 2.x 的兼容性解决方案：

1. 禁用 Spring Boot 的默认日志系统（如上文提到的 System.setProperty）。
2. 手动配置 Logback。

5. 测试日志功能

• 升级完成后，务必全面测试日志功能，确保以下内容正常工作：
  • 日志输出到控制台和文件。
  • 日志滚动策略（如按时间或大小分割日志文件）。
  • 自定义日志配置生效。

6. 注意事项

• CVE 漏洞修复：Logback 1.3.x 修复了许多安全漏洞（如 CVE-2021-42550、CVE-2021-44294 等），建议尽快升级以提高安全性。
• 向后兼容性：部分旧版功能可能被移除或修改，需仔细阅读 Logback 官方文档 和 迁移指南。
• 性能优化：Logback 1.3.x 对性能进行了改进，但在某些场景下可能会出现行为差异，需注意观察。

通过以上步骤，你可以顺利将 Logback 从 1.2.x 升级到 1.3.x，同时确保项目的稳定性和安全性。