JUnit测试报错：无法初始化org.apache.logging.log4j.util.PropertiesUtil类

可能的原因与修复步骤 #

1. 检查Log4j2依赖完整性 #

NoClassDefFoundError 通常不是类找不到，而是类初始化阶段出错。先确认依赖是否覆盖所有必要组件：

• 确保log4j-core和log4j-api版本完全一致（你当前都是2.19.0，这点没问题，但要排查是否有其他版本的Log4j2依赖混入类路径）
• 如果项目之前用SLF4J适配Log4j1，迁移后需替换为log4j-slf4j-impl桥接包，避免SLF4J适配冲突
• 若用到Java Util Logging，需补充log4j-jul适配包

2. 定位类初始化失败的根源 #

PropertiesUtil初始化失败多因加载配置或系统属性出错，可通过以下方式排查：

• 在JUnit测试的VM参数中添加-Dlog4j2.debug=true，开启调试模式，查看Log4j2初始化的详细日志，定位具体报错点
• 检查测试环境的log4j.configurationFile属性是否指向不存在或格式错误的配置文件
• 确认测试资源目录下是否存在多个Log4j2配置文件（如log4j2.xml、log4j2.properties），导致加载逻辑混乱

3. 处理Mockito与Log4j2的兼容性 #

Mockito 2.15.0版本偏旧，可能与Log4j2 2.19.0存在兼容性问题：

• 尝试升级Mockito至2.28.2及以上版本，老版本的字节码操作逻辑可能干扰Log4j2的类初始化
• 若无法升级Mockito，且项目使用PowerMock，可在测试类添加@PowerMockIgnore("org.apache.logging.log4j.*")，避免Mockito拦截Log4j2类加载
• 或者在测试类的@BeforeClass方法中手动初始化Log4j2，比如调用LogManager.getContext(false)

4. 排查隐性类路径冲突 #

即使排除了Log4j1，仍可能存在隐性冲突：

• 用Maven的dependency:tree或Gradle的dependencies任务分析依赖树，检查是否有其他依赖间接引入了不同版本的Log4j2或冲突类
• 确保类路径中不同时存在log4j-over-slf4j和log4j-slf4j-impl，这两个包无法共存
• 移除旧的Log4j1桥接包（如log4j-to-slf4j），迁移到Log4j2后这些包已无用

5. 调整测试环境类加载逻辑 #

JUnit测试的类加载器与Web应用存在差异，可能导致初始化失败：

• 将Log4j2配置文件放在测试资源目录（src/test/resources）下，确保测试时能正确加载
• 若使用自定义类加载器，检查是否允许加载Log4j2相关类
• 对于Java EE项目，排查测试时是否引入了容器类加载器的干扰逻辑

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