






















要利用 Logback 的热加载特性,关键不在于文件放在哪里(因为 JAR 包内的文件无法热修改),而在于必须将配置文件外置。
默认情况下,Spring Boot 打包 JAR 时,logback.xml 会被打包进 JAR 包内部的 BOOT-INF/classes/ 目录下。这部分内容是只读的,无法在运行时修改,因此无法实现热加载。
Spring Boot 的日志加载机制有一个优先级顺序:它会优先读取 JAR 包同级目录下的配置文件。
将 logback.xml(或 logback-spring.xml)文件放在与你的 JAR 包相同的目录下。
目录结构示例:
/opt/myapp/
├── myapp.jar
└── logback-spring.xml <-- 放在这里
仅仅把文件放在外面还不够,你必须在 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>
按照以下步骤操作,即可实现不停机修改日志目录:
logback-spring.xml 复制出来,放在 JAR 包同级目录。logback-spring.xml 中的日志路径(例如从 /var/log 改为 /data/logs)。scanPeriod 指定的时间(如 30 秒)。Spring Boot 的加载优先级:
Spring Boot 日志系统初始化时,会按照以下顺序寻找配置文件(优先级由高到低):
logback-spring.xml (即 JAR 包同级目录)logback.xmllogback-spring.xmllogback.xml因为外部文件优先级最高,且文件系统是可写的,所以 Logback 的 scan 特性才能生效。
关于 logback.xml vs logback-spring.xml:
推荐使用 logback-spring.xml。这是 Spring Boot 特有的命名,它允许你使用 <springProfile> 等高级特性(针对不同环境配置不同日志策略),并且同样支持 scan 热加载。
位置: 放在 JAR 包同级目录。
前提: 必须在 <configuration> 标签中配置 scan="true"。
效果: 修改外部 XML 文件中的路径后,Logback 会在设定的扫描周期内自动检测并应用新配置,无需重启 Java 进程。这是最安全、优雅的日志目录迁移方案。
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。