Log4j2程序式配置生成的日志文件无内容写入该如何解决？

核心问题点 #

• 配置初始化方法使用错误：当Log4j2已经完成默认初始化（比如类路径下存在默认配置文件、或之前已调用过LogManager.getLogger）时，Configurator.initialize不会替换现有配置，仅会在首次初始化时生效，这是绝大多数场景下配置不生效、日志写不进去的原因。
• 自定义logger未显式关闭日志叠加（additivity）：默认additivity为true，日志会同时传递给父logger（RootLogger），虽然不会导致完全写不进，但会产生重复日志的隐患。
• 初始化后未显式激活上下文：部分版本Log4j2需要手动触发上下文更新才能让配置生效。

修复后的代码 #

private static void configureLog4J() 
{
    ConfigurationBuilder<BuiltConfiguration> builder = ConfigurationBuilderFactory.newConfigurationBuilder();
    builder.setStatusLevel(Level.WARN);
    builder.setConfigurationName("RollingBuilder");
    
    // 控制台appender
    AppenderComponentBuilder appenderBuilder = builder.newAppender("Stdout", "CONSOLE")
        .addAttribute("target", ConsoleAppender.Target.SYSTEM_OUT);
    appenderBuilder.add(builder.newLayout("PatternLayout")
        .addAttribute("pattern", "%d [%t] %-5level: %msg%n%throwable"));
    builder.add(appenderBuilder);
    
    // 滚动文件appender
    LayoutComponentBuilder layoutBuilder = builder.newLayout("PatternLayout")
        .addAttribute("pattern", "%d [%t] %-5level: %msg%n");
    ComponentBuilder triggeringPolicy = builder.newComponent("Policies")
        .addComponent(builder.newComponent("CronTriggeringPolicy").addAttribute("schedule", "0 0 0 * * ?"))
        .addComponent(builder.newComponent("SizeBasedTriggeringPolicy").addAttribute("size", "10M"));
    appenderBuilder = builder.newAppender("ChangeLogFile", "RollingFile")
        .addAttribute("fileName", "/var/log/test/changelog.log")
        .addAttribute("filePattern", "/var/log/test/changelog-%d{MM-dd-yy}.log.gz")
        // 显式开启立即刷新，避免缓存导致日志迟迟不写入
        .addAttribute("immediateFlush", true)
        .add(layoutBuilder)
        .addComponent(triggeringPolicy);
    builder.add(appenderBuilder);

    // 自定义changelog logger，显式设置additivity为false，禁止日志传递到父logger
    builder.add(builder.newLogger("changelog", Level.DEBUG)
        .addAttribute("additivity", false)
        .add(builder.newAppenderRef("ChangeLogFile")));

    builder.add(builder.newRootLogger(Level.WARN)
        .add(builder.newAppenderRef("Stdout"))); // 这里建议RootLogger绑定控制台，避免和自定义logger输出冲突
    
    // 核心修正：使用reconfigure替换initialize，强制覆盖现有配置
    BuiltConfiguration config = builder.build();
    Configurator.reconfigure(config);
}

额外注意事项 #

• 必须保证configureLog4J()方法的执行时机早于所有LogManager.getLogger()调用，不要在持有static Logger实例的类中执行该初始化方法，避免Log4j2提前完成默认初始化。
• 确保/var/log/test目录对应用程序进程有读写权限，你目前可以生成文件说明权限没问题，但需确认没有磁盘空间不足、文件被锁定的情况。
• 打日志时确保日志级别≥DEBUG，比如changelog.debug("测试日志")、changelog.info("操作日志")都可以正常写入，TRACE级别会被过滤。

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