Spring Boot（Tomcat部署）中application.properties的logging.config未生效

问题分析 #

直接放置log4j2.xml能生效，但通过application.properties的logging.config指定外部路径不生效，通常是以下几个原因：

• Windows路径转义错误
• Tomcat进程无目标文件读取权限
• 日志系统加载早于Spring Boot配置文件，导致logging.config未被及时读取

解决方案 #

1. 修正路径格式 #

Windows系统中，配置路径的反斜杠需要转义，或者改用正斜杠：

# 方式1：转义反斜杠
logging.config=file:C:\\Users\\...\\log4j2-configuration.xml
# 方式2：使用正斜杠
logging.config=file:C:/Users/.../log4j2-configuration.xml

2. 确保Tomcat有文件读取权限 #

将log4j2-configuration.xml放到Tomcat有权限访问的目录，比如Tomcat的conf目录下，然后修改路径：

logging.config=file:${catalina.base}/conf/log4j2-configuration.xml

3. 通过Tomcat启动参数指定日志配置 #

由于日志系统在Spring Boot启动前就初始化，application.properties中的配置可能无法及时生效，建议直接在Tomcat的启动脚本中添加JVM参数：

# Windows catalina.bat开头添加
set JAVA_OPTS=%JAVA_OPTS% -Dlogging.config=file:C:/Users/.../log4j2-configuration.xml

# Linux catalina.sh开头添加
JAVA_OPTS="$JAVA_OPTS -Dlogging.config=file:/path/to/log4j2-configuration.xml"

4. 用Profile区分环境（更推荐） #

如果要区分开发/生产环境，更优雅的方式是使用Spring Profile：

• 在src/main/resources下创建log4j2-dev.xml和log4j2-prod.xml
• 在application.properties中指定激活的Profile：

spring.profiles.active=dev

• Spring Boot会自动识别log4j2-${profile}.xml格式的文件，加载对应环境的日志配置

5. 检查依赖完整性 #

确保所有Spring Boot Starter都排除了默认的logging依赖，比如spring-boot-starter-data-jpa、spring-boot-starter-webflux这类starter也可能引入spring-boot-starter-logging，需要逐个排除：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-logging</artifactId>
        </exclusion>
    </exclusions>
</dependency>

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