Log4J2配置中SystemPropertiesLookup值未加载即使用的解决方案咨询

这个问题我之前也碰到过——Log4J2的上下文初始化时机确实会早于main方法执行，尤其是当代码里有静态Logger实例的时候，导致你在main里设置的系统属性没能被配置文件读取到。下面给你几个不需要完全转为Java代码配置的解决方案：

方案1：手动触发Log4J2初始化（最推荐） #

在main方法里先设置好系统属性，再手动调用Log4J2的初始化方法，强制它用最新的系统属性加载配置。这样既保留了XML配置的便利性，又能确保属性生效。

代码示例：

public class YourMainClass {
    public static void main(String[] args) {
        // 第一步：先设置你的系统属性
        System.setProperty("MIGRATION_ENV", "dev");
        System.setProperty("MIGRATION_TITLE", "user-data-migration");
        
        // 第二步：手动初始化Log4J2，classpath下的配置文件直接写文件名即可
        org.apache.logging.log4j.core.config.Configurator.initialize(
            null, 
            YourMainClass.class.getClassLoader(), 
            "log4j2.xml"
        );
        
        // 之后再获取Logger使用
        Logger logger = LogManager.getLogger(YourMainClass.class);
        logger.debug("系统属性已生效，日志文件名正确生成");
    }
}

原理是：Configurator.initialize()会重新初始化Log4J2的上下文，此时系统属性已经设置完成，配置文件里的${sys:XXX:-UNKNOWN}就能正确读取到值了。

方案2：避免静态Logger提前初始化 #

如果你的代码里有静态Logger实例（比如private static final Logger logger = LogManager.getLogger(XXX.class);），这类静态字段会在类加载阶段就触发Log4J2初始化，早于main方法执行。你可以把Logger改为实例字段，或者延迟静态Logger的初始化：

public class YourServiceClass {
    // 先声明静态Logger，不立即初始化
    private static Logger logger;

    public void doSomething() {
        // 确保在main设置属性后再初始化Logger
        if (logger == null) {
            logger = LogManager.getLogger(YourServiceClass.class);
        }
        logger.debug("业务日志");
    }
}

不过这个方案需要修改所有类的Logger声明，工作量较大，除非你项目里Logger很少，否则更推荐方案1。

方案3：动态配置替换（进阶，适合复杂场景） #

如果需要更灵活的属性替换，可以自定义ConfigurationFactory，在加载XML配置时动态注入属性值。不过这个需要写少量Java代码，核心思路是继承XmlConfigurationFactory，重写配置加载逻辑，把你设置的系统属性注入进去。这个方案适合需要动态生成属性的场景，但对大多数情况来说，方案1已经足够。

测试验证：用方案1修改后，日志文件名会从app-UNKNOWN-UNKNOWN.log变成app-dev-user-data-migration.log，完全符合你的需求。

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