Log4j2无法输出日志到控制台/文件 无法加载log4j2.xml配置

核心根因 #

• Classpath配置错误（核心问题）：运行程序时-cp参数写法完全错误，没有将当前目录、三个Log4j依赖包加入类路径，导致JVM无法找到log4j2.xml配置文件。Log4j2扫描不到配置时会默认使用仅输出ERROR级别日志到控制台的空配置，代码中打印的INFO级别日志自然不会输出，也不会生成日志文件。
• 调试参数使用错误：使用的-Dlog4j.debug是Log4j 1.x的调试参数，Log4j2的内部日志开启参数为-Dlog4j2.debug，因此看不到配置加载的内部提示。
• API误用：BasicConfigurator.configure()是Log4j 1.x的初始化方法，在Log4j2环境下不生效，即使引入了1.x桥接包也无法触发Log4j2的配置初始化。
• Logger匹配存在隐患：代码中通过AzulMain.class.getName()获取Logger，如果类声明了自定义包，配置中写的name="AzulMain"无法匹配到对应Logger，会导致日志走Root Logger配置，和预期的绑定规则不符。

分步修复方案 #

1. 修正配置文件存放路径
   不要把log4j2.xml和Java源码文件放在同一目录，标准项目结构下将配置文件放入src/main/resources目录，IDE会自动将该目录下的文件编译输出到类路径根目录。如果手动编译，要保证log4j2.xml和编译后的.class文件在同一层级的类路径下。
2. 修正运行命令的Classpath配置
   假设三个Log4j依赖包、编译后的AzulMain.class都在当前目录，不同环境运行命令如下：
   • Windows环境：

   java -Dlog4j2.debug -cp ".;log4j-api-2.17.2.jar;log4j-core-2.17.2.jar;log4j-1.2-api-2.17.2.jar" AzulMain
   

   • Linux/macOS环境：

   java -Dlog4j2.debug -cp ".:log4j-api-2.17.2.jar:log4j-core-2.17.2.jar:log4j-1.2-api-2.17.2.jar" AzulMain
   

   注意：-cp参数的首个值.代表当前目录，必须加入才能让JVM扫描到当前路径下的配置文件和class文件
3. 修正配置文件的Logger匹配规则
   自定义Logger的name属性必须和代码中获取Logger时传入的名称完全一致：如果AzulMain类没有声明包，保持现有name="AzulMain"即可；如果类在自定义包下（如com.demo.AzulMain），需要将name改为全限定类名。
   新手使用建议直接在Root Logger上绑定所有需要的Appender，避免匹配失败：

   <Root level="info" additivity="false">
     <AppenderRef ref="Console-Appender"/>
     <AppenderRef ref="File-Appender-AzulMain"/>
     <AppenderRef ref="RollingFile-Appender"/>
   </Root>
   

4. 验证修复结果
   加上-Dlog4j2.debug参数运行后，控制台会打印Log4j2内部加载日志，出现Loaded configuration from [file:xxx/log4j2.xml]相关提示即代表配置加载成功，此时INFO级别日志会正常输出到控制台和指定日志目录。

补充说明：手动调用Configurator.initialize(new DefaultConfiguration())能正常输出日志，就是因为绕过了自动配置扫描逻辑，直接给Log4j2注入了默认配置，这也侧面印证了核心问题是自动配置扫描阶段找不到log4j2.xml文件。

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