Spring Boot 2.6.0集成Log4j2无法读取Docker/K8s环境变量怎么办

问题根因 #

Spring Boot默认日志初始化时机早于Spring上下文初始化，你之前用的Log4j原生配置读取方式，只会读取静态配置文件或者Log4j自己初始化时能拿到的系统参数，无法识别Spring加载的Docker/K8s环境变量，也不会遵循Spring Boot的配置优先级规则。而@Value是Spring上下文完全初始化、所有配置源加载完成后才注入的，所以可以正常读取。

解决步骤 #

1. 确认依赖配置正确
   首先确保你已经排除Spring Boot默认的logback依赖，引入了log4j2的官方starter：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <!-- 排除默认logback -->
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 引入log4j2 starter -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-log4j2</artifactId>
</dependency>

2. 修改日志配置文件名
   把你现有的log4j2.properties重命名为log4j2-spring.properties，放在src/main/resources目录下。这是Spring Boot约定的命名规则，带-spring后缀的日志配置文件会由Spring Boot接管初始化，才能支持读取Spring环境中的所有配置。

3. 修改日志路径读取配置
   修改log4j2-spring.properties中的filename配置，使用Spring专属的Lookup前缀读取配置：

# 自动遵循Spring Boot配置优先级：环境变量 > 系统变量 > 外部配置文件 > 内部配置文件
property.filename = ${spring:log.file.path}

这个配置会自动优先读取Docker/K8s注入的LOG_FILE_PATH环境变量，不存在时才会用application.properties里的默认值logs/dev/my-app，完全符合你的需求。
如果需要直接读取环境变量不走Spring配置优先级，也可以直接写：

# 注意环境变量名是大写，找不到就用后面的默认值
property.filename = ${env:LOG_FILE_PATH:-logs/dev/my-app}

4. 原有配置无需改动
   你现有的application.properties和Docker Compose配置不需要修改，部署后日志路径会自动切换为logs/prod/my-app。

之前写法失效的原因 #

• ${bundle:application:log.file.path}是Log4j原生的资源束读取逻辑，只会加载classpath下的静态application.properties文件，不会读取Spring整合的外部动态配置。
• ${sys:logpath}和${env:logpath}失效有两个原因：一是你配置的环境变量是大写的LOG_FILE_PATH，变量名不匹配；二是普通Log4j配置文件初始化早于Spring上下文，此时Spring还没把环境变量同步到系统属性中，Log4j读取不到。

内容的提问来源于stack exchange，提问作者Jeebendu kumar Behera