SpringBoot集成LogBack：如何避免生成初始空日志文件？

我之前在Spring Boot项目里遇到过一模一样的问题！折腾了好一阵才找到根源，给你梳理下解决方案：

问题根源分析 #

你碰到的两个核心问题：

1. 多余的空文件生成：你引入的Spring Boot默认file-appender.xml里定义了一个名为FILE的Appender，它会直接使用${LOG_FILE}变量创建文件，但没有关联LOG_PATH，所以默认会在当前工作目录生成ts-msgs.log——哪怕你没在任何Logger里引用这个Appender，Logback初始化时还是会尝试创建它。
2. 只读目录创建文件失败：你的自定义MSG_LOG_FILE Appender在Logback启动初始化阶段就会尝试创建空文件，而如果工作目录是只读的，这直接就会触发IO异常导致程序终止。

具体解决方案 #

1. 移除不必要的默认文件Appender引入 #

直接删掉这行配置，因为你已经自定义了MSG_LOG_FILE，完全不需要Spring Boot提供的默认文件Appender：

<include resource="org/springframework/boot/logging/logback/file-appender.xml" />

这一步就能解决工作目录生成空ts-msgs.log的问题。

2. 给自定义Appender开启懒加载 #

在你的MSG_LOG_FILE Appender里添加<lazyInit>true</lazyInit>配置，让Logback只在第一次有日志需要写入时才创建文件，而不是启动时就生成空文件：

<appender name="MSG_LOG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <lazyInit>true</lazyInit> <!-- 新增这行 -->
    <file>${LOG_PATH}/${LOG_FILE}</file>
    <!-- 其他编码器、滚动策略配置保持不变 -->
</appender>

这能彻底避免在只读目录下因为提前创建文件而抛出的异常。

3. 优化LOG_PATH的属性解析（可选） #

如果你的日志路径是通过Spring Boot配置文件（比如application.properties里的logging.path）设置的，建议改用Spring占位符语法，让Logback能更准确地获取Spring环境变量：

<property name="LOG_PATH" value="${logging.path:${java.io.tmpdir:-/tmp}}" />

这比纯Logback占位符更贴合Spring Boot的属性加载逻辑，减少路径解析出错的概率。

修改后的完整配置 #

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <property name="LOG_PATH" value="${logging.path:${java.io.tmpdir:-/tmp}}" />
    <property name="LOG_FILE" value="${LOG_FILE:-ts-msgs.log}" />
    <include resource="org/springframework/boot/logging/logback/defaults.xml" />

    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <Pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</Pattern>
        </encoder>
    </appender>

    <appender name="MSG_LOG_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <lazyInit>true</lazyInit>
        <file>${LOG_PATH}/${LOG_FILE}</file>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} ${LOG_LEVEL_PATTERN:-%5p} ${PID:- } --- [%t] %-40.40logger{39} : %m%n%wex</Pattern>
        </encoder>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/archived/debug.%d{yyyy-MM-dd}.%i.log</fileNamePattern>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>10MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
    </appender>

    <logger name="com.example.somepackagename" additivity="false" level="debug">
        <appender-ref ref="MSG_LOG_FILE" />
    </logger>

    <logger name="org.springframework" additivity="false" level="info">
        <appender-ref ref="STDOUT" />
    </logger>

    <root level="warn">
        <appender-ref ref="STDOUT" />
    </root>
</configuration>

验证效果 #

启动项目后：

• 工作目录不会再生成多余的空日志文件
• 只有当com.example.somepackagename包有日志输出时，才会在LOG_PATH指定的临时目录创建ts-msgs.log文件
• 只读目录下也不会再因为创建文件而抛出异常

内容的提问来源于stack exchange，提问作者mmo