log4j2 配置文件需按优先级顺序放置：jvm参数指定路径 > classpath根目录的log4j2.xml或log4j2.json > meta-inf/log4j-provider.properties指定位置；maven项目应确保log4j2.xml置于src/main/resources，spring boot推荐用log4j2-spring.xml并配置logging.config。
Log4j2 的 log4j2.xml 放哪才生效
Log4j2 启动时会按固定顺序扫描配置文件，不是随便放个路径就能被加载。最常踩的坑是把 log4j2.xml 放在 src/main/java 下却没进 classpath，或者打成 jar 后配置被忽略。
- 优先级从高到低：JVM 参数
-Dlog4j.configurationFile=xxx.xml> classpath 根目录下的log4j2.xml或log4j2.json> classpath 下log4j2.xml在META-INF/log4j-provider.properties指定的位置 - Maven 项目务必确认
src/main/resources是资源目录（IDE 中显示为蓝色文件夹），否则 XML 不会被复制进target/classes/ - Spring Boot 用户注意：
spring-boot-starter-log4j2会接管初始化，直接放log4j2.xml可能被跳过，改用log4j2-spring.xml并配logging.config属性更稳
为什么 Logger.getLogger("X") 返回 null 或不输出日志
这通常不是代码写错了，而是 Log4j2 尚未完成初始化，或 Logger 名称与配置中的 <logger></logger> 不匹配。
- 检查是否触发了自动配置：启动时加 JVM 参数
-Dorg.apache.logging.log4j.simplelog.StatusLogger.level=TRACE，能看到 Log4j2 加载过程和失败原因 -
Logger.getLogger("com.example.Service")要想生效，配置里得有对应<logger name="com.example.Service" level="debug"></logger>，否则走 root logger；没配 root logger 就彻底静默 - Web 应用中，如果用的是 Servlet 3.0+ 容器（如 Tomcat 8+），确保没有手动调用
LogManager.shutdown()或重复初始化，否则上下文丢失
异步日志（AsyncLogger）开启后反而变慢甚至死锁
异步日志不是开个开关就万事大吉，它依赖 LMAX Disruptor，线程模型和阻塞策略直接影响行为。
- 必须引入
disruptor依赖（Log4j2 2.17+ 已不内置），Maven 写法：<artifactid>disruptor</artifactid>，缺了它会退化为同步模式且无提示 -
AsyncLoggerContextSelector需在log4j2.xml顶部声明：<configuration status="warn" packages="org.apache.logging.log4j.core.async"></configuration>，并设系统属性-DLog4jContextSelector=org.apache.logging.log4j.core.async.AsyncLoggerContextSelector - 避免在
toString()、日志参数构造中做耗时操作（如 DB 查询、远程调用），异步线程池满时会阻塞或丢日志，默认策略是DiscardingAsyncQueueFullPolicy
Log4j2 初始化失败但控制台没报错，怎么定位
Log4j2 初始化出问题时，常常“静默失败”——既不输出日志，也不抛异常，只留下一个空的 Logger 实例。关键是要打开它的内部状态日志。
立即学习“Java免费学习笔记（深入）”；
- 在 JVM 启动参数里加：
-Dorg.apache.logging.log4j.simplelog.StatusLogger.level=TRACE -Dorg.apache.logging.log4j.simplelog.StatusLogger.console=true - 观察输出里是否有
Unable to locate plugin type for Appender（比如用了KafkaAppender却没引对应依赖）、Invalid element XXX（XML 格式错误）、No appenders found（root logger 没配 appender） - 特别注意类加载冲突：老项目混用 log4j-1.x 和 log4j2，或 slf4j-log4j12 绑定，会导致 Log4j2 的
Provider被跳过，此时 StatusLogger 也打不出日志
Log4j2 初始化链条比表面看起来深得多，配置路径、类加载器、依赖版本、甚至 JDK 版本（如 Java 17 的 sealed 类限制）都可能成为断点。别信“放对位置就跑起来”，多看 StatusLogger 输出才是第一手证据。
