spring boot项目应排除默认日志并引入spring-boot-starter-log4j2；log4j2.xml须置于src/main/resources根目录且命名准确；root logger的level需小写、appenderref名称须严格匹配大小写。
Log4j2依赖怎么引才不会冲突
Maven里直接加log4j-core和log4j-api是最容易出问题的起点。Spring Boot项目尤其要注意：如果用了spring-boot-starter-logging，它默认带的是Logback，硬塞Log4j2会触发SLF4J绑定冲突，启动时抛NoClassDefFoundError: org/apache/logging/log4j/core/Appender这类错。
实操建议：
- Spring Boot 2.4+ 用户必须排除默认日志实现：
<exclusion><br> <groupId>org.springframework.boot</groupId><br> <artifactId>spring-boot-starter-logging</artifactId><br></exclusion>
- 再显式引入
spring-boot-starter-log4j2（它已配好log4j-api和log4j-core版本对齐）- 普通Java SE项目，只加
log4j-core和log4j-api两个jar，别漏掉log4j-core——光有API没用，日志根本写不出去
log4j2.xml放哪才算被加载
Log4j2不会自动扫src/main/resources下所有XML，它只认几个固定路径和文件名：log4j2.xml、log4j2.json、log4j2.yaml，且必须在类路径根目录（即编译后出现在target/classes/最顶层）。
常见错误现象：
- 放在src/main/resources/config/log4j2.xml → 启动时打印ERROR StatusLogger No log4j2 configuration file found
- 文件名写成log4j.xml或log4j2-config.xml → 完全静默失效，连警告都不报
- 多模块项目里，XML只放在某个子模块resources下，但主启动类不在该模块 → 不加载
实操建议：
- 确保路径是src/main/resources/log4j2.xml（不要嵌套子目录）
- 启动时加JVM参数-Dlog4j2.debug=true，看控制台是否输出Using configuration file及具体路径
- 如果必须放别处，用-Dlog4j.configurationFile=xxx.xml指定绝对路径或类路径相对路径（如config/log4j2.xml），但注意此时文件仍需在类路径内
root logger配置写错会导致日志全丢
很多人复制示例时只改了appender名字，却漏掉root节点里的level或appender-ref，结果程序跑起来没任何日志输出，连ERROR都不打。
典型问题：
- <root level="error"></root>写成<root level="ERROR"></root> → Log4j2不认大写，降级为ERROR但实际按默认ERROR处理（看似正常，实则掩盖了warn/info丢失）
- 忘记加<appenderref ref="Console"></appenderref> → root没挂任何appender，日志直接被丢弃
- 在<appenders></appenders>里定义了Console，但<appenderref ref="CONSOLE"></appenderref>大小写不一致 → 引用失败，无报错，无声无息
实操建议：
- root level统一用小写：debug、info、warn、error
- 检查每个AppenderRef ref="X"的X是否和<appenders></appenders>里对应<console name="X"></console>完全一致（含大小写）
- 开发期先设level="debug"，确认日志能打出再调低
Log4j2的配置生效与否，不看有没有报错，而要看StatusLogger那几行初始化日志——尤其是Using configuration file后面跟的路径，以及Starting LoggerContext之后有没有列出你定义的appender。很多问题就卡在“以为配了，其实压根没加载”。
立即学习“Java免费学习笔记（深入）”；
