Log4j2依赖需同时引入log4j-api和log4j-core，否则运行时报错；配置文件log4j2.xml须置于src/main/resources下且命名准确；RootLogger级别与Appender绑定必须正确；多模块中可用log4j2.component.properties指定配置优先加载。
Log4j2依赖没生效，检查log4j-api和log4j-core是否都引入了
Log4j2是双jar设计：只加log4j-api会编译通过但运行时报NoClassDefFoundError: org/apache/logging/log4j/core/Appender；只加log4j-core则连Logger.getLogger()都找不到。Maven里必须同时声明：
<dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.20.0</version> </dependency> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-core</artifactId> <version>2.20.0</version> </dependency>
- Spring Boot项目优先用
spring-boot-starter-log4j2，它已自动管理版本和传递依赖 - 排除掉旧版
log4j或slf4j-log4j12，否则可能触发类加载冲突 - Gradle用户注意
api和implementation作用域差异，log4j-api应设为api
log4j2.xml不被加载，确认文件位置和命名是否符合约定
Log4j2默认按固定顺序查找配置文件，log4j2.xml必须放在src/main/resources（Maven结构）下，且不能放在子目录里。常见失效原因：
- 文件名写成
log4j.xml（Log4j 1.x格式）或log4j2.yml（需额外依赖log4j-core的YAML支持） - 打包后检查
target/classes/log4j2.xml是否存在，IDE里有时资源未自动复制 - 启动时加JVM参数
-Dlog4j.configurationFile=classpath:log4j2-dev.xml可强制指定路径，但文件仍须在classpath中 - 使用
ClassLoader.getSystemResource("log4j2.xml")打印路径，验证是否真能加载到
日志输出为空或格式不对，检查Appender配置和RootLogger级别
配置文件里Appender定义了输出目标（控制台、文件等），但即使配了，如果RootLogger的level设得太高，或者没把Appender绑定过去，照样没日志。
<RootLogger level="info"> <AppenderRef ref="Console"/> <AppenderRef ref="File"/> </RootLogger>
-
level设为debug才能看到logger.debug("xxx")，info级别会过滤掉debug日志 -
AppenderRef的ref值必须和Appender的name完全一致，大小写敏感 - 控制台输出乱码？在
ConsoleAppender里加charset="UTF-8"属性（2.17+支持） - 文件Appender没生成日志？确认
fileName路径有写入权限，Windows下别用C:\logs\app.log这种绝对路径
多模块项目中log4j2.xml被覆盖，用log4j2.component.properties隔离配置
当多个jar包都含log4j2.xml时，JVM只加载第一个（类路径顺序决定），容易导致配置被意外替换。最稳妥的做法不是删掉其他模块的配置，而是用log4j2.component.properties文件控制加载行为：
立即学习“Java免费学习笔记（深入）”；
- 在
src/main/resources下新建log4j2.component.properties - 写入
log4j2.configurationFile=log4j2-main.xml，然后把主配置重命名为该名字 - 这个properties文件本身不会被覆盖，且优先级高于默认查找逻辑
- 如果模块间日志策略差异大，建议用
LoggerContext编程式初始化，而非依赖自动发现
配置路径这件事，表面是放哪的问题，实际是类加载器、资源查找机制和构建工具行为的叠加结果。哪怕路径写对了，也得挨个验证是否真进了classpath、是否被其他jar遮蔽、是否被IDE缓存干扰——这些环节漏一个，日志就静音。
