log4j升级log4j2后配置加载正常但控制台无日志输出问题

• Logger实例初始化时机错误：静态Logger在外部配置加载前就通过LogManager.getLogger()完成初始化，绑定的是Log4j2启动时加载的默认空配置，后续重配置时没有完成引用更新，无法关联到新加载的ConsoleAppender。
• 重复触发重配置流程：调用context.setConfigLocation(file.toURI())时Log4j2内部会自动触发一次配置重载，后续手动调用context.reconfigure()会触发第二次重配置，第一次加载完成的stdout Appender会在第二次重配置时被标记为停止状态，无法承接日志输出。
• 配置语法兼容问题：配置中rootLogger.appenderRefs = stdout是Log4j2早期测试版的语法，正式稳定版不需要单独声明appenderRefs列表，旧语法在部分版本中会出现Appender引用绑定异常。

• 调整代码执行顺序，移除冗余的重配置调用，确保Logger实例在外部配置加载完成后再初始化，修正后代码如下：

import org.apache.logging.log4j.Logger;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.LoggerContext;
import java.io.File;

public class StealthServices {
    // 不要在类加载阶段提前初始化静态Logger
    private static Logger log;

    public static void main(String[] args) {
        System.out.println("file name: " + args[1]);
        final LoggerContext context = LoggerContext.getContext(false);
        File file = new File(args[1]);
        // setConfigLocation本身会自动触发配置加载，不需要额外调用reconfigure
        context.setConfigLocation(file.toURI());
        // 配置加载完成后再获取Logger实例
        log = LogManager.getLogger(StealthServices.class);

        // 测试日志输出
        log.info("日志系统初始化完成");
    }
}

• 修正log4j2.properties配置语法，移除冗余的旧版配置项，修正后配置如下：

packages=mnav
status=trace
shutdownHook=disable

appender.console.name = stdout
appender.console.type = Console
appender.console.layout.type=PatternLayout
appender.console.layout.pattern=%d %-5p %c %x %m%n

rootLogger.level=debug
# 移除旧版语法rootLogger.appenderRefs = stdout，直接配置Appender引用
rootLogger.appenderRef.stdout.ref = stdout

• 如果业务要求必须在类加载阶段初始化静态Logger，在配置加载完成后追加一行context.updateLoggers();，主动刷新所有已初始化的Logger引用，绑定新配置的Appender即可。

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