使用Jetty Maven插件时Log4j2指定配置文件未生效问题

我之前也踩过这个坑，Log4j2默认会优先扫描classpath下的log4j2.xml，所以哪怕你定义了log4j-dev.location，如果没明确告诉JVM要加载这个路径的配置，应用还是会乖乖用WEB-INF/classes里的默认文件。下面给你几个实用的解决办法：

方法一：修改Jetty Maven插件配置，添加系统属性 #

在你的pom.xml的jetty-maven-plugin配置里，加上JVM启动参数，直接指定Log4j2要使用的配置文件。Log4j2专门识别的系统属性是log4j.configurationFile，你可以把它指向你的开发环境配置：

<plugin>
    <groupId>org.eclipse.jetty</groupId>
    <artifactId>jetty-maven-plugin</artifactId>
    <version>你的Jetty版本号</version>
    <configuration>
        <!-- 保留你原有的其他配置 -->
        <jvmArgs>-Dlog4j.configurationFile=${log4j-dev.location}</jvmArgs>
    </configuration>
</plugin>

这里要确保${log4j-dev.location}是正确的路径，比如你的开发配置在src/main/resources/log4j2-dev.xml，可以直接写成file:src/main/resources/log4j2-dev.xml，或者提前在pom里用<properties>定义好这个路径变量。

方法二：启动时通过命令行传递系统参数 #

如果不想修改pom.xml，也可以在执行启动命令时直接附加参数：

mvn clean jetty:run -Dlog4j.configurationFile=file:/你的配置文件绝对路径/log4j2-dev.xml

注意一定要加file:前缀，告诉Log4j2这是文件系统里的配置文件，不是classpath里的资源。

方法三：通过Maven资源过滤自动替换配置（可选） #

这种适合需要在构建阶段自动切换环境配置的场景：

1. 在src/main/resources下保留生产环境的log4j2.xml，把开发配置命名为log4j2-dev.xml。
2. 在pom.xml里配置开发profile，让构建时自动把log4j2-dev.xml重命名为log4j2.xml并覆盖到classpath：

<profiles>
    <profile>
        <id>dev</id>
        <build>
            <resources>
                <resource>
                    <directory>src/main/resources</directory>
                    <excludes>
                        <exclude>log4j2.xml</exclude>
                    </excludes>
                </resource>
                <resource>
                    <directory>src/main/resources</directory>
                    <includes>
                        <include>log4j2-dev.xml</include>
                    </includes>
                    <targetPath>.</targetPath>
                    <rename>
                        <from>log4j2-dev.xml</from>
                        <to>log4j2.xml</to>
                    </rename>
                </resource>
            </resources>
        </build>
    </profile>
</profiles>

启动时指定dev profile即可：

mvn clean jetty:run -Pdev

这几种方法里，前两种最直接，尤其是方法一，配置一次就能长期用。你可以根据自己的实际场景选最合适的方式。

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