使用Maven执行测试项目时Log4j2无法写入日志文件

• 检查Log4j2配置文件的打包位置
  确保log4j2.xml（或.properties）被正确打包进框架JAR的/resources目录。Maven默认仅打包src/main/resources和src/test/resources下的文件，若配置在其他目录，需在框架模块的pom.xml中添加资源打包规则：

  <build>
    <resources>
      <resource>
        <directory>src/main/resources</directory>
        <includes>
          <include>**/log4j2.xml</include>
        </includes>
      </resource>
    </resources>
  </build>
  

  可直接解压框架JAR，确认配置文件是否存在且路径正确。

• 验证Maven执行时的类路径
  确认框架JAR已正确引入测试项目的依赖，且依赖范围为test：

  <dependency>
    <groupId>你的框架groupId</groupId>
    <artifactId>你的框架artifactId</artifactId>
    <version>版本号</version>
    <scope>test</scope>
  </dependency>
  

  执行mvn dependency:build-classpath查看完整类路径，确保Log4j2相关JAR和配置文件都在路径内。

• 统一日志文件的写入路径
  Maven执行mvn clean test时的工作目录是项目根目录，而IntelliJ运行TestNG时可能用模块目录，相对路径会导致写入位置不一致。建议：

  1. 在测试项目的pom.xml的Surefire插件中指定日志路径变量：

     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
       <artifactId>maven-surefire-plugin</artifactId>
       <version>3.0.0</version>
       <configuration>
         <systemPropertyVariables>
           <log.path>${project.basedir}/logs</log.path>
         </systemPropertyVariables>
       </configuration>
     </plugin>
     

  2. 在log4j2.xml中引用该变量：${sys:log.path}/test.log，同时确保${project.basedir}/logs目录存在且有写入权限。

• 排查Log4j2依赖冲突
  框架打包后可能引入重复或版本不一致的Log4j2依赖，执行mvn dependency:tree查看依赖树，排除冲突项：

  <dependency>
    <groupId>你的框架groupId</groupId>
    <artifactId>你的框架artifactId</artifactId>
    <version>版本号</version>
    <scope>test</scope>
    <exclusions>
      <exclusion>
        <groupId>org.apache.logging.log4j</groupId>
        <artifactId>log4j-core</artifactId>
      </exclusion>
    </exclusions>
  </dependency>
  

  确保测试项目中统一使用相同版本的Log4j2核心与API依赖。

• 配置Surefire插件加载Log4j2配置
  在Surefire插件中显式指定Log4j2配置文件路径，避免Maven执行时无法自动加载：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0</version>
    <configuration>
      <argLine>-Dlog4j.configurationFile=classpath:log4j2.xml</argLine>
    </configuration>
  </plugin>
  

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