Java配置Log4j2生成日志文件未在指定位置出现的问题求助

问题描述 #

尝试通过Java代码配置Log4j2，将日志文件生成到指定位置，但日志并未出现在预期路径中，相关代码与配置如下：

Java代码片段 #

static {
    try {
        System.setProperty("logFilePath", System.getProperty("user.dir")+"/app.log");
        configLevelData = HelperMethods.getGlobalVarsFromConfig(configFilePath);
        log = LogManager.getLogger(Runner.class);
    } catch (Exception e) {
        e.printStackTrace();
        throw new RuntimeException(e);
    }
}

log4j2.xml配置 #

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="DEBUG">
    <Appenders>

        <RollingFile name="LogToFile"
                     fileName="${logFilePath}"
                     filePattern="{DEFAULT}" append="false">
            <PatternLayout pattern="%d{DEFAULT} [%t] %-5level %logger{36} - %msg%n"/>
            <Policies>
                <SizeBasedTriggeringPolicy size="19500KB"/>
            </Policies>
        </RollingFile>
    </Appenders>
    <Loggers>
        <Logger name="com.vodafone.tv.runner" level="debug" additivity="false">
            <AppenderRef ref="LogToFile"/>
        </Logger>
        <Logger name="com.vodafone.tv.utils.CollectFiles" level="info" additivity="false">
            <AppenderRef ref="LogToFile"/>
        </Logger>
        <Root level="info">
            <AppenderRef ref="LogToFile"/>
        </Root>
    </Loggers>
</Configuration>

可能原因与解决方法 #

1. 系统属性设置时机滞后 #

Log4j2可能在static块执行前就完成了初始化，导致${logFilePath}未被正确解析。

解决：

• 优先通过JVM启动参数传递属性，运行程序时添加：

  -DlogFilePath=${user.dir}/app.log
  

• 若必须在代码中设置，确保在任何Log4j2相关操作（如LogManager.getLogger()）之前执行System.setProperty，比如将设置代码放在main方法的最开头。

2. RollingFile的filePattern配置错误 #

配置中filePattern="{DEFAULT}"不是合法的滚动文件命名模式，会导致RollingFileAppender无法正常工作，进而无法写入日志。

解决：
修改filePattern为符合规则的格式，例如：

filePattern="${logFilePath}.%i.log"

这样当日志文件达到大小限制时，会生成app.log.1、app.log.2等滚动文件。

3. 配置文件未被正确加载 #

若存在其他Log4j2配置文件（如log4j2.properties），或当前log4j2.xml不在classpath根目录，可能导致配置未生效。

解决：

• 确认log4j2.xml放在项目的classpath根目录（如src/main/resources）；
• 若路径特殊，通过JVM参数指定配置文件路径：

  -Dlog4j.configurationFile=path/to/your/log4j2.xml
  

4. 调试验证 #

• 在代码中添加打印，确认系统属性是否正确设置：

  System.out.println("当前logFilePath：" + System.getProperty("logFilePath"));
  

• 查看Log4j2的DEBUG日志（配置中已设置status="DEBUG"），检查控制台输出，确认fileName是否被解析为预期路径，以及配置文件是否被成功加载。

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