Logback控制台日志级别过滤不符合预期问题求助

核心问题定位 #

当前控制台默认输出DEBUG日志，根源是root logger级别设为DEBUG后，控制台appender继承了该级别，覆盖了你通过LOG_LEVEL变量设置的默认值；之前添加独立控制台logger时，因配置逻辑错误（如未关联appender、级别冲突、additivity设置不当）导致无日志输出。

满足需求的正确配置 #

以下配置完全符合你的三个需求：

1. 默认控制台输出INFO，可通过-Dlog.level=DEBUG参数切换为DEBUG级别
2. DEBUG及以上日志单独输出至ROLLING_FILE_DEBUG
3. INFO及以上日志输出至ROLLING_FILE

<configuration>
    <!-- 定义可通过JVM参数覆盖的日志级别变量，默认值INFO -->
    <property name="LOG_LEVEL" value="${log.level:INFO}" />
    <property name="LOG_PATH" value="./logs" />

    <!-- 控制台输出Appender：通过过滤器控制输出级别 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <!-- 关键：用ThresholdFilter拦截低于指定级别的日志，优先级高于root级别 -->
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>${LOG_LEVEL}</level>
        </filter>
    </appender>

    <!-- INFO级别滚动文件Appender -->
    <appender name="ROLLING_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/app.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/app.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>100MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>10GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>INFO</level>
        </filter>
    </appender>

    <!-- DEBUG级别滚动文件Appender -->
    <appender name="ROLLING_FILE_DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${LOG_PATH}/app-debug.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy">
            <fileNamePattern>${LOG_PATH}/app-debug.%d{yyyy-MM-dd}.%i.log.gz</fileNamePattern>
            <maxFileSize>100MB</maxFileSize>
            <maxHistory>30</maxHistory>
            <totalSizeCap>10GB</totalSizeCap>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.ThresholdFilter">
            <level>DEBUG</level>
        </filter>
    </appender>

    <!-- Root Logger：级别设为DEBUG，确保所有日志能到达各Appender，再由Appender的过滤器筛选 -->
    <root level="DEBUG">
        <appender-ref ref="CONSOLE" />
        <appender-ref ref="ROLLING_FILE" />
        <appender-ref ref="ROLLING_FILE_DEBUG" />
    </root>
</configuration>

关键配置说明 #

• 控制台级别控制：ThresholdFilter是核心，它会直接截断低于指定级别的日志，不受root级别的影响（root设为DEBUG是为了让所有级别的日志能传递到appender，再由过滤器做最后筛选）
• 无需独立控制台Logger：直接通过root关联所有appender即可，独立Logger容易因additivity设置、级别冲突等问题导致日志丢失或重复
• 验证步骤：
  • 无JVM参数时：控制台仅输出INFO及以上日志，ROLLING_FILE输出INFO及以上，ROLLING_FILE_DEBUG输出DEBUG及以上
  • 添加-Dlog.level=DEBUG参数：控制台输出DEBUG及以上日志，文件输出逻辑保持不变

之前尝试的问题复盘 #

你之前添加独立控制台Logger导致无日志输出，大概率是以下原因之一：

• 独立Logger的级别设置高于root，导致日志被提前拦截
• 未给独立Logger关联CONSOLE appender
• 设置了additivity="false"但未将文件appender关联到root，导致文件日志丢失

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