17370845950

SpringBoot项目日志配置失效排查指南

在使用SpringBoot整合Slf4j和Log4j2时，有时会遇到log4j2.xml配置文件失效的问题，导致日志输出与预期不符。本文将分析并解决“SpringBoot整合Slf4j+Log4j2，log4j2.xml配置失效”这一常见问题。

问题：开发者排除了log4j2.xml文件本身错误，怀疑是默认配置覆盖了自定义配置。

分析：观察pom.xml文件，发现以下关键配置：

1. 显式排除spring-boot-starter-logging依赖: 这意在替换SpringBoot默认的日志框架（Logback）。

   
       org.springframework.boot
       spring-boot-starter-web
       
           
               org.springframework.boot
               spring-boot-starter-logging
           
       
   

2. 引入spring-boot-starter-log4j2依赖: 这部分配置正确，引入Log4j2作为日志框架。

   
       org.springframework.boot
       spring-boot-starter-log4j2
   

然而，问题在于即使显式排除，spring-boot-starter-logging仍可能被其他依赖间接引入，例如mybatis-spring-boot-starter。 mybatis-spring-boot-starter自身或其依赖可能包含spring-boot-starter-logging，导致冲突，从而使Logback的默认配置生效，覆盖自定义的log4j2.xml配置。

解决方案：

1. 检查依赖树: 仔细检查mybatis-spring-boot-starter及其依赖树，确认是否存在spring-boot-starter-logging依赖。可以使用Maven或Gradle的依赖树命令查看。

2. 排除依赖: 如果确认mybatis-spring-boot-starter间接引入了spring-boot-starter-logging，则需要在pom.xml中对mybatis-spring-boot-starter进行类似的排除操作：

   
       org.mybatis.spring.boot
       mybatis-spring-boot-starter
       
           
               org.springframework.boot
               spring-boot-starter-logging
           
       
   

3. 调试日志: 将Spring的日志级别设置为DEBUG，观察启动日志。这有助于确认log4j2.xml是否被正确加载和解析，并找出潜在的冲突信息。

通过以上步骤，您可以有效排查并解决log4j2.xml配置文件失效的问题，确保Log4j2正确地应用于您的SpringBoot项目。