Spring Boot自定义Logback日志仅输出至文件问题排查

我碰到过好多次这个问题啦，核心原因其实是Logback的日志传播机制在搞鬼！你设置了logging.level.root=INFO但还是看到自定义Logger的DEBUG/TRACE日志出现在控制台，大概率是因为自定义Logger默认会把日志向上传递给父Logger（包括Root），而Spring Boot默认给Root绑定了控制台Appender，哪怕Root级别是INFO，也会接收并输出这些传播过来的日志。

下面给你一步步解决的方法：

最关键的一步：关闭自定义Logger的日志传播 #

你需要在Logback配置里给自定义Logger加上additivity="false"，这个属性会阻止日志事件向上传递到父Logger的Appender，这样自定义日志就只会输出到你指定的文件里。

举个logback-spring.xml的配置示例：

<!-- 先定义你的自定义文件Appender -->
<appender name="CUSTOM_DEBUG_APPENDER" class="ch.qos.logback.core.FileAppender">
    <file>logs/custom-debug.log</file> <!-- 你的自定义日志路径 -->
    <encoder>
        <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
    </encoder>
    <!-- 可选：只让这个Appender接收DEBUG及以上级别日志 -->
    <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
        <level>DEBUG</level>
    </filter>
</appender>

<!-- 配置自定义Logger，绑定上面的Appender并关闭传播 -->
<logger name="com.yourpackage.yourcustomlogger" level="DEBUG" additivity="false">
    <appender-ref ref="CUSTOM_DEBUG_APPENDER"/>
</logger>

<!-- Root Logger保持默认，输出INFO及以上到控制台 -->
<root level="INFO">
    <appender-ref ref="CONSOLE"/>
</root>

额外排查点（如果上面的方法没解决） #

• 检查重复配置：看看你的application.properties或application.yml里有没有把自定义Logger加到某个日志组里，比如logging.group.console=com.yourpackage.yourcustomlogger，这种设置会强制把日志输出到控制台。
• 确认配置文件优先级：Spring Boot优先读取logback-spring.xml，如果你同时有logback.xml，可能会出现配置冲突，建议统一用logback-spring.xml。
• 验证Appender级别过滤：虽然这和控制台输出无关，但确保你的自定义Appender只接收你需要的级别（比如DEBUG/TRACE），避免冗余日志。

修改完配置后重启应用，随便打一条DEBUG日志试试，应该就只会出现在你的自定义文件里，控制台不会再显示啦！

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