SpringBoot集成Log4j2启动报错，如何让Log4j2延后初始化？

问题背景 #

在log4j2.yml中通过Spring属性配置Logstash参数：

Properties:
    property:
      - name: LOGSTASH_HOST
        value: ${spring:logstash.server.host}
      - name: LOGSTASH_PORT
        value: ${spring:logstash.server.port}
      - name: APPLICATION_NAME
        value: ${lower:${spring:spring.application.name:-spring}}

启动应用时会触发两类报错：

ERROR StatusConsoleListener Resolver failed to lookup spring:logstash.server.host
java.lang.IllegalStateException: Unable to obtain Spring Environment from LoggerContext

ERROR StatusConsoleListener Unable to write to stream TCP:localhost:9800 for appender LOGSTASH
org.apache.logging.log4j.core.appender.AppenderLoggingException: Error writing to TCP:localhost:9800: socket not available at org.apache.logging.log4j.core.net.TcpSocketManager.write(TcpSocketManager.java:214)

报错原因是Log4j2初始化时机早于Spring环境加载完成，导致无法读取Spring配置的属性，直到SpringBoot完全启动后日志功能才恢复正常。

已尝试的方案：

• 排除spring-boot-starter-logging并引入spring-boot-starter-log4j2
• 配置系统属性/环境变量作为Spring属性的备用值

有效解决方案 #

1. 全局延迟Log4j2初始化 #

在Spring Boot的配置文件（application.yml/application.properties）中添加以下配置，让Log4j2等待Spring环境完全就绪后再初始化：

logging.log4j2.config.defer-logger-initialization: true

这是最直接的方案，能彻底解决启动阶段因属性未加载导致的报错。

2. 针对Logstash Appender做延迟配置 #

如果不需要全局延迟初始化，仅针对Logstash Appender优化：
在log4j2.yml中给Logstash的TCP Appender添加以下配置：

Appenders:
  TCP:
    name: LOGSTASH
    destination: "${spring:logstash.server.host:-localhost}:${spring:logstash.server.port:-5044}"
    immediateFlush: false
    ignoreExceptions: true
    connectTimeout: 5000 # 延长连接超时时间，给Spring环境加载留足时间
    # 保留你的encoder等其他配置

• ignoreExceptions: true会让Appender忽略启动阶段的连接异常，避免报错输出
• connectTimeout设置为5秒左右，确保Spring环境能在超时前完成属性加载
• 保留Spring属性占位符+默认值的配置，确保极端情况下有 fallback 值

3. 确保Log4j2与Spring集成的扩展生效 #

确认项目中已正确引入spring-boot-starter-log4j2，该starter包含了Log4j2与Spring环境集成的扩展（log4j-spring），能让Log4j2在Spring环境就绪后动态获取属性。如果依赖缺失，可手动添加：

<dependency>
    <groupId>org.apache.logging.log4j</groupId>
    <artifactId>log4j-spring</artifactId>
    <version>${log4j2.version}</version>
</dependency>

注：${log4j2.version}需与Spring Boot依赖的Log4j2版本保持一致，通常Spring Boot的bom会自动管理版本，无需手动指定。

内容的提问来源于stack exchange，提问作者Máté Kiss