Spring Boot集成Log4j2配置不生效及自定义包日志级别异常排查

一、彻底清理日志依赖冲突 #

首先确认Gradle中已完全排除冲突日志组件，避免Logback或默认Logging starter干扰：

1. 执行依赖树检查命令，排查残留依赖：

   ./gradlew dependencies --configuration runtimeClasspath | grep logging
   

2. 若发现spring-boot-starter-logging或logback-classic残留，通过全局配置强制排除：

   configurations {
       all {
           exclude group: 'org.springframework.boot', module: 'spring-boot-starter-logging'
           exclude group: 'ch.qos.logback', module: 'logback-classic'
       }
   }
   
   dependencies {
       implementation 'org.springframework.boot:spring-boot-starter-log4j2'
       // 其他业务依赖
   }
   

二、定位实际加载的Log4j2配置文件 #

添加JVM启动参数打印Log4j2初始化日志，明确应用加载的配置文件路径：

-Dlog4j2.debug=true

启动后控制台会输出类似Loaded configuration from [file:/xxx/xxx/log4j2.xml]的日志，直接定位是否有其他配置文件被优先加载。

三、修复自定义包日志级别不生效问题 #

1. 检查配置文件中的Logger规则，确保自定义包配置正确且优先级高于Root：

   <Loggers>
       <!-- 自定义包日志规则：需放在Root节点之前 -->
       <Logger name="de.myapp" level="debug" additivity="false">
           <AppenderRef ref="Console"/>
       </Logger>
       <!-- 根日志规则 -->
       <Root level="info">
           <AppenderRef ref="Console"/>
       </Root>
   </Loggers>
   

   注意：name需与包名完全匹配，additivity="false"可避免日志重复输出到Root的Appender。
2. 确认代码中Logger初始化正确，使用Log4j2原生API或SLF4J绑定：

   // 原生Log4j2初始化
   import org.apache.logging.log4j.LogManager;
   import org.apache.logging.log4j.Logger;
   
   public class MyService {
       private static final Logger logger = LogManager.getLogger(MyService.class);
   }
   

   若用SLF4J门面，确保依赖中仅存在log4j-slf4j-impl绑定（spring-boot-starter-log4j2已包含，无需额外添加）。

四、排查其他配置来源 #

• 检查系统环境变量：是否设置了LOG4J_CONFIGURATION_FILE，该变量会覆盖默认配置路径。
• 检查启动参数：是否通过-Dlog4j.configurationFile=xxx指定了其他配置文件。
• 检查classpath：排查是否存在log4j2.properties/log4j2.yml等其他格式的配置文件，这些文件可能被优先加载。
• 检查Spring Boot配置：application.properties中是否设置logging.config，需确保指向目标配置文件，如logging.config=classpath:log4j2.xml。

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