Spring Boot整合Log4j遇初始化警告问题排查

核心问题：依赖版本不兼容 #

Spring Boot 2.7.1属于2.x版本，而你引入的spring-boot-starter-log4j 1.3.8.RELEASE是适配Spring Boot 1.3.x的老版本，两者存在严重版本不匹配，这是日志初始化异常的根本原因之一。

缺失/错误配置项修复 #

1. 修正依赖配置 #

移除spring-boot-starter-log4j，改用Log4j 1.x与Spring Boot 2.x兼容的依赖组合：

• 保留原有log4j:log4j:1.2.17依赖
• 添加SLF4J到Log4j 1.x的桥接依赖，避免Spring内部日志API冲突：

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-log4j12</artifactId>
    <version>1.7.36</version> <!-- 适配Spring Boot 2.7.x的SLF4J版本 -->
</dependency>

确保完全排除spring-boot-starter-logging：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-websocket</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 确保Log4j配置文件正确加载 #

• 确认log4j.xml放置在src/main/resources/config目录下，Spring Boot会自动扫描该目录的配置文件
• 检查配置文件中是否为根日志或org.springframework.boot.env包配置了对应appender：

<!-- 根日志配置，关联自定义appender -->
<root>
    <priority value="INFO" />
    <appender-ref ref="你的自定义Appender名称" />
</root>

<!-- 针对Spring Boot配置加载类的日志单独配置，消除特定警告 -->
<logger name="org.springframework.boot.env" additivity="false">
    <level value="INFO" />
    <appender-ref ref="你的自定义Appender名称" />
</logger>

3. 验证自定义FileAppender配置正确性 #

• 确保log4j.xml中自定义appender的class属性是自定义类的全限定类名，示例：

<appender name="CustomFileAppender" class="com.yourpackage.config.CustomFileAppender">
    <!-- 配置FileAppender必需参数 -->
    <param name="File" value="logs/app.log" />
    <layout class="org.apache.log4j.PatternLayout">
        <param name="ConversionPattern" value="%d{yyyy-MM-dd HH:mm:ss} %-5p %c{1}:%L - %m%n" />
    </layout>
</appender>

• 检查自定义Appender类是否正确重写activateOptions()方法（如果需要自定义初始化逻辑）

4. 强制Log4j提前初始化 #

Spring Boot启动时会先加载配置文件，此时Log4j可能未完成初始化，导致加载YAML配置的类无法找到appender。可通过JVM参数强制提前初始化：

-Dlog4j.configuration=classpath:config/log4j.xml

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