Log4j2 FatJar编程式配置失效求助：仅控制台输出错误日志，滚动文件无日志

看起来你遇到的是Log4j2动态配置在可执行Jar包中无法正常工作的典型问题——IDE里运行一切正常，但打包后RollingFileAppender完全没输出，只有控制台的错误日志能显示。我来帮你拆解可能的原因和对应的解决方案：

1. 首要排查：日志目录是否存在且可写 #

这是最常见的坑：IDE运行时你的logPath对应的目录可能已经存在（比如项目根目录下的logs文件夹），但打包成FatJar后，你运行Jar的当前工作目录可能没有这个目录，RollingFileAppender会静默失败（Log4j2默认不会因为文件创建失败抛出异常）。

解决方法：在构建配置前先确保日志目录存在：

File logDir = new File(logPath);
if (!logDir.exists()) {
    // 递归创建目录，包括父目录
    if (!logDir.mkdirs()) {
        throw new RuntimeException("无法创建日志目录: " + logPath);
    }
}

这样如果目录创建失败，你能立刻得到明确的错误，而不是莫名其妙的日志丢失。

2. 调整LogManager.shutdown()的时机 #

你在初始化新配置前调用了LogManager.shutdown()，这可能会干扰后续的配置加载流程，尤其是在FatJar的类加载环境下。建议把这行代码移到新配置初始化完成之后，或者干脆去掉——除非你明确需要清理之前的日志上下文。

3. 开启Log4j2内部调试日志，定位问题 #

如果上面两步还没解决，你需要看看Log4j2自身的启动日志，它会告诉你Appender初始化是否成功、有没有找不到组件等问题。在代码最开头添加：

import org.apache.logging.log4j.status.StatusLogger;
import org.apache.logging.log4j.Level;

// 开启Log4j2内部状态日志，输出到控制台
StatusLogger.getLogger().setLevel(Level.DEBUG);

运行FatJar时，控制台会输出Log4j2的内部调试信息，比如：

RollingFileAppender rollingFile could not create file ...
或者找不到某个组件的错误

这些信息能直接帮你定位根因。

4. 确认FatJar打包时包含了所有Log4j2依赖 #

虽然你用代码构建配置，但Log4j2的核心组件（比如RollingFileAppender、PatternLayout）还是需要在FatJar中存在。确保你的打包脚本（比如Maven Shade或Gradle Shadow）没有排除Log4j2的相关依赖：

• 必须包含log4j-core和log4j-api
• 如果用了TimeBasedTriggeringPolicy，确保log4j-core里的相关类被正确打包（Shade插件默认会包含，但如果有自定义过滤规则要检查）

修改后的完整示例代码 #

import org.apache.logging.log4j.Level;
import org.apache.logging.log4j.LogManager;
import org.apache.logging.log4j.core.config.ConfigurationBuilder;
import org.apache.logging.log4j.core.config.ConfigurationBuilderFactory;
import org.apache.logging.log4j.core.config.Configurator;
import org.apache.logging.log4j.core.layout.PatternLayout;
import org.apache.logging.log4j.core.appender.ConsoleAppender;
import org.apache.logging.log4j.core.appender.RollingFileAppender;
import org.apache.logging.log4j.core.appender.rolling.TimeBasedTriggeringPolicy;
import org.apache.logging.log4j.core.appender.rolling.SizeBasedTriggeringPolicy;
import org.apache.logging.log4j.core.appender.rolling.CompositeTriggeringPolicy;
import org.apache.logging.log4j.status.StatusLogger;

import java.io.File;

public class LogConfig {
    public static void initLogger(String logPath) {
        // 开启Log4j2内部调试日志
        StatusLogger.getLogger().setLevel(Level.DEBUG);

        // 确保日志目录存在
        File logDir = new File(logPath);
        if (!logDir.exists()) {
            if (!logDir.mkdirs()) {
                throw new RuntimeException("无法创建日志目录: " + logDir.getAbsolutePath());
            }
        }

        String logFile = logPath + "dxpos.log";
        String logFilePattern = logPath + "dxpos-%d{yyyy-MM-dd}.log";

        ConfigurationBuilder<?> builder = ConfigurationBuilderFactory.newConfigurationBuilder();

        // 构建PatternLayout
        PatternLayout layout = builder.newLayout("PatternLayout")
                .addAttribute("pattern", "%d{yyyy-MM-dd HH:mm:ss} %-5p [%t] %c: %m%n")
                .build();

        // 构建ConsoleAppender
        ConsoleAppender console = builder.newAppender("console", "Console")
                .addAttribute("target", ConsoleAppender.Target.SYSTEM_OUT)
                .addAttribute("immediateFlush", true)
                .add(layout)
                .build();

        // 构建触发策略
        CompositeTriggeringPolicy triggeringPolicy = builder.newComponent("Policies")
                .addComponent(builder.newComponent("TimeBasedTriggeringPolicy"))
                .addComponent(builder.newComponent("SizeBasedTriggeringPolicy").addAttribute("size", "100M"))
                .build();

        // 构建RollingFileAppender
        RollingFileAppender rollingFile = builder.newAppender("rollingFile", "RollingFile")
                .addAttribute("fileName", logFile)
                .addAttribute("filePattern", logFilePattern)
                .addAttribute("immediateFlush", true)
                .addAttribute("append", true)
                .addComponent(triggeringPolicy)
                .add(layout)
                .build();

        // 配置根Logger
        builder.add(console);
        builder.add(rollingFile);
        builder.newRootLogger(Level.INFO)
                .add(builder.newAppenderRef("console"))
                .add(builder.newAppenderRef("rollingFile"));

        // 初始化配置
        Configurator.initialize(builder.build());

        // 如果需要清理旧的日志上下文，再调用shutdown
        // LogManager.shutdown();
    }
}

最后验证一下 #

打包FatJar后，运行时加上-Dlog4j2.debug参数，也能输出Log4j2的内部日志：

java -Dlog4j2.debug -jar dx.jar

这会帮你彻底排查配置加载过程中的任何问题。

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