log4j2日志文件未生成求助：IDEA可运行Jar包日志异常

检查日志路径配置 #

• 确认log4j2.xml中日志文件的路径配置：如果使用相对路径（比如logs/app.log），Jar运行时的工作目录和IDEA中运行时的工作目录可能不一致。可以改为绝对路径，或者用${sys:user.dir}/logs/app.log这种基于当前Jar运行目录的动态路径。

针对Maven/Gradle项目的打包配置 #

Maven项目 #

• 确保pom.xml中配置了resources节点，保证src/main/resources下的log4j2.xml被正确打包：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*.xml</include>
            </includes>
            <filtering>false</filtering>
        </resource>
    </resources>
    <!-- 使用maven-shade-plugin打包可运行Jar时，需配置transformer避免冲突 -->
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.4.1</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>你的主类全路径</mainClass>
                            </transformer>
                            <!-- 处理Log4j2的服务配置，避免被覆盖 -->
                            <transformer implementation="org.apache.maven.plugins.shade.resource.AppendingTransformer">
                                <resource>META-INF/services/org.apache.logging.log4j.spi.LoggerContextFactory</resource>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 在IDEA右侧Maven面板点击Reload All Maven Projects，确保配置生效后执行package命令。

Gradle项目 #

• 确保build.gradle中shadowJar插件配置正确，包含配置文件和依赖：

plugins {
    id 'java'
    id 'com.github.johnrengelman.shadow' version '7.1.2'
}

shadowJar {
    manifest {
        attributes 'Main-Class': '你的主类全路径'
    }
    // 确保资源文件被打包进Jar
    from sourceSets.main.resources
}

• 在IDEA右侧Gradle面板点击Refresh all Gradle projects，然后执行shadowJar任务生成可运行Jar。

针对IDEA原生Artifact打包的配置 #

• 打开File > Project Structure > Artifacts，选中你创建的可运行Jar Artifact：
  1. 在Output Layout中，确认src/main/resources下的log4j2.xml已添加到Jar的类路径位置（比如Jar根目录）。如果没有，点击+ > Directory Content，选择src/main/resources目录添加。
  2. 切换到Manifest File标签，确认Main Class已正确指定，且Class-Path包含所有Log4j2相关依赖Jar（如果依赖未打包进Jar）。若要将依赖一起打包，需在Artifact配置中选择Extract to the target JAR选项。
• 重新构建Artifact（Build > Build Artifacts > Rebuild）后再运行生成的Jar。

其他排查点 #

• 运行Jar时添加-Dlog4j2.debug=true参数，查看控制台输出的Log4j2初始化日志，确认是否加载到log4j2.xml，以及日志生成失败的具体原因（如权限不足、路径不存在）。
• 解压Jar包检查：确认log4j2.xml在类路径下，同时Log4j2核心依赖（如log4j-core-*.jar、log4j-api-*.jar）已被正确打包或在运行时类路径中。

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