Spring Boot2.0升级后Log4j2日志无法输出至文件求助

我之前也踩过几乎一模一样的坑！Spring Boot 2.x对日志依赖的调整藏了不少细节，控制台正常但文件没输出，大概率是依赖配置、日志文件配置或者权限的问题，咱们一步步来排查解决：

1. 先确认Log4j2的依赖是否正确配置 #

Spring Boot 2.x默认集成的是Logback，替换成Log4j2时，必须完全排除默认日志依赖，同时引入正确的Log4j2 starter，还要避免第三方依赖偷偷引入Logback。

Maven配置示例： #

<!-- 排除默认的Logback依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

<!-- 引入Log4j2 starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

Gradle配置示例： #

configurations {
    all {
        exclude group: 'org.springframework.boot', module: 'spring-boot-starter-logging'
    }
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-log4j2'
}

验证依赖： 执行mvn dependency:tree（Maven）或gradle dependencies（Gradle），确保没有ch.qos.logback相关的依赖，所有日志依赖都是org.apache.logging.log4j开头的。

2. 检查Log4j2的配置文件是否正确 #

Log4j2的配置格式和旧版Log4j差异很大，别直接把旧的log4j.properties改个后缀就用，必须按照Log4j2的规则来写。

关键配置要点： #

• 配置文件命名：Spring Boot 2.x默认识别classpath:log4j2.xml、classpath:log4j2-spring.xml或classpath:log4j2.properties，确保文件名和位置正确。
• 必须同时配置控制台Appender和文件Appender，并让RootLogger同时引用两者。
• 注意文件路径的配置：相对路径是相对于程序运行的工作目录，建议用绝对路径测试，或者用Spring的占位符（比如${user.home}/logs/app.log）。

正确的log4j2.xml示例： #

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="INFO">
    <Appenders>
        <!-- 控制台输出 -->
        <Console name="Console" target="SYSTEM_OUT">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
        </Console>
        <!-- 文件输出（滚动日志） -->
        <RollingFile name="RollingFile" fileName="${user.home}/logs/myapp.log"
                     filePattern="${user.home}/logs/myapp-%d{yyyy-MM-dd}-%i.log">
            <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="10MB"/>
                <TimeBasedTriggeringPolicy/>
            </Policies>
            <DefaultRolloverStrategy max="10"/>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Root level="INFO">
            <!-- 必须同时添加Console和RollingFile两个Appender -->
            <AppenderRef ref="Console"/>
            <AppenderRef ref="RollingFile"/>
        </Root>
    </Loggers>
</Configuration>

常见错误：

• 忘记在RootLogger里引用文件Appender，导致只有控制台输出。
• 文件路径配置错误，比如目录不存在，或者程序没有写入权限。
• 日志级别配置冲突：比如RootLogger是INFO，但文件Appender单独设置了ERROR级别，导致INFO日志无法写入文件。

3. 检查文件路径权限 #

如果配置的路径是系统目录（比如Linux的/var/log，Windows的C:\Program Files），程序运行用户可能没有写入权限。

• 测试方法：先把文件路径改成用户目录（比如${user.home}/logs），看看是否能生成日志文件。
• Linux下：确保日志目录的所有者是程序运行用户，或者设置chmod 777临时测试（不建议生产环境用）。
• Windows下：右键以管理员身份运行程序，测试是否能生成文件。

4. 强制指定日志配置文件（排查加载问题） #

有时候Spring Boot可能没有加载到正确的配置文件，可以在启动时通过参数强制指定：

java -jar your-app.jar --logging.config=classpath:log4j2.xml

如果这样配置后文件日志正常输出，说明原来的配置文件没有被正确加载，检查文件名是否正确，或者是否放在了resources目录下（Maven/Gradle默认的资源目录）。

最后总结 #

按照这个顺序排查：先确认依赖完全替换，再检查配置文件的Appender引用和路径，然后验证权限，最后强制指定配置文件。一般来说，90%的问题都出在依赖或配置文件上。

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