利用 Logback 的热加载特性,安全的迁移日志,改变日志保存路径

要利用 Logback 的热加载特性，关键不在于文件放在哪里（因为 JAR 包内的文件无法热修改），而在于必须将配置文件外置。

默认情况下，Spring Boot 打包 JAR 时，logback.xml 会被打包进 JAR 包内部的 BOOT-INF/classes/ 目录下。这部分内容是只读的，无法在运行时修改，因此无法实现热加载。

实现方案：将配置文件放在 JAR 包同级目录

Spring Boot 的日志加载机制有一个优先级顺序：它会优先读取 JAR 包同级目录下的配置文件。

1. 放置位置

将 logback.xml（或 logback-spring.xml）文件放在与你的 JAR 包相同的目录下。

目录结构示例：

/opt/myapp/
├── myapp.jar
└── logback-spring.xml  <-- 放在这里

2. 核心配置：开启热加载

仅仅把文件放在外面还不够，你必须在 logback-spring.xml 的根节点 <configuration> 上添加 scan 属性。

配置示例 (logback-spring.xml)：

<configuration scan="true" scanPeriod="30 seconds">
    <!-- 
        scan="true": 开启热加载特性
        scanPeriod="30 seconds": 默认每60秒检测一次，这里改为30秒
    -->
  
    <property name="LOG_PATH" value="/data/logs/myapp" />
  
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/info.log</file>
        <!-- 其他配置... -->
    </appender>
  
    <root level="INFO">
        <appender-ref ref="FILE" />
    </root>
</configuration>

3. 操作步骤

按照以下步骤操作，即可实现不停机修改日志目录：

1. 提取配置： 将 JAR 包内的 logback-spring.xml 复制出来，放在 JAR 包同级目录。
2. 重启应用（仅一次）： 重启应用，让 Spring Boot 读取外部的配置文件。
   • 验证：启动后查看日志输出，确认配置已生效。
3. 热修改：
   • 修改外部 logback-spring.xml 中的日志路径（例如从 /var/log 改为 /data/logs）。
   • 等待 scanPeriod 指定的时间（如 30 秒）。
   • Logback 会检测到文件变化，自动重新加载配置。
   • 新的日志内容将写入新目录，旧日志文件保留在原位。

原理补充说明

1. Spring Boot 的加载优先级：
   Spring Boot 日志系统初始化时，会按照以下顺序寻找配置文件（优先级由高到低）：

   1. 当前目录下的 logback-spring.xml (即 JAR 包同级目录)
   2. 当前目录下的 logback.xml
   3. Classpath (JAR 包内) 下的 logback-spring.xml
   4. Classpath (JAR 包内) 下的 logback.xml

   因为外部文件优先级最高，且文件系统是可写的，所以 Logback 的 scan 特性才能生效。

2. 关于 logback.xml vs logback-spring.xml：
   推荐使用 logback-spring.xml。这是 Spring Boot 特有的命名，它允许你使用 <springProfile> 等高级特性（针对不同环境配置不同日志策略），并且同样支持 scan 热加载。

总结

位置： 放在 JAR 包同级目录。
前提： 必须在 <configuration> 标签中配置 scan="true"。
效果： 修改外部 XML 文件中的路径后，Logback 会在设定的扫描周期内自动检测并应用新配置，无需重启 Java 进程。这是最安全、优雅的日志目录迁移方案。