当多个 JUnit 测试共享同一个静态类（如含 static final Logger 的工具类）时，Mockito 的 mockStatic 仅对首次类加载生效，后续测试无法重新绑定 mock 实例，导致 verify 失败。本文提供两种可靠解决方案。
当多个 junit 测试共享同一个静态类（如含 static final logger 的工具类）时，mockito 的 `mockstatic` 仅对首次类加载生效，后续测试无法重新绑定 mock 实例，导致 verify 失败。本文提供两种可靠解决方案。
在使用 Mockito 5+ 的 MockedStatic 对静态方法（如 LogManager.getLogger()）进行模拟时，一个常见却隐蔽的陷阱是：静态字段的初始化只发生一次。以 MyCoreLog 类为例：
private static final Logger logger = LogManager.getLogger("MyCoreLog");该行代码在 JVM 第一次主动使用 MyCoreLog 类（例如调用 MyCoreLog.error(...)）时执行，logger 字段被赋值为 LogManager.getLogger(...) 的返回结果。而 MockedStatic 只能拦截 LogManager.getLogger() 的调用——但它无法修改已经初始化完成的 static final 字段。因此：
- 第一个测试执行时，mockStatic 拦截了 getLogger()，返回你创建的 mock(Logger.class)，并成功赋值给 MyCoreLog.logger；
- 第二个测试执行时，MyCoreLog 类已加载且静态字段已初始化完毕，getLogger() 调用虽被拦截并返回新 mock，但该新 mock 永远不会写入 MyCoreLog.logger —— 它仍持有着第一个测试中创建的旧 mock（或真实 logger）引用，导致 verify() 针对新 mock 的断言必然失败。
✅ 正确解法一：复用单一 mock 实例（推荐）
核心思想：避免为每个测试创建独立 mock，而是在测试类生命周期内只创建一个 mock，并确保所有测试都使用它。关键点在于：
- 将 mock 声明为 static final，保证单例；
- 在 @BeforeEach 中统一配置 mockStatic 的行为，使其始终返回该唯一 mock；
- 所有 verify() 都针对这个共享 mock。
class CoreLogTest {
private static final MockedStatic<LogManager> logManager = mockStatic(LogManager.class);
private static final Logger loggerMock = mock(Logger.class); // ✅ 单一共享 mock
@BeforeEach
void setUp() {
// 每次测试前重置 mock 状态（清除之前 verify 记录）
reset(loggerMock);
// 统一让 getLogger("MyCoreLog") 总是返回同一个 mock
logManager.when(() -> LogManager.getLogger("MyCoreLog")).thenReturn(loggerMock);
}
@AfterEach
void tearDown() {
logManager.close(); // 或在 @AfterAll 中关闭（若需跨测试保持）
}
@Test
void error() {
MyCoreLog.error("error message");
verify(loggerMock).error("error message");
}
@Test
void errorWith() {
MyCoreLog.error("error message 2");
verify(loggerMock).error("error message 2"); // ✅ 现在能正确验证
}
}⚠️ 注意：务必在 @BeforeEach 中调用 reset(loggerMock)，否则前一个测试的 verify 状态（如已调用次数）会污染下一个测试。
✅ 正确解法二：绕过 mock，直接验证日志行为（更健壮）
若业务逻辑对日志内容敏感（如格式、占位符），Mockito 静态 mock 易受类加载顺序影响。此时建议放弃 mock Logger，改用 Log4j2 内置的 ListAppender 捕获实际日志事件，实现端到端验证：
@Test
void errorWith_realLoggingVerification() {
// 1. 获取或创建专用 Logger（与 MyCoreLog 使用同名）
Logger testLogger = LogManager.getLogger("MyCoreLog");
// 2. 添加内存 Appender 捕获日志
ListAppender listAppender = ListAppender.newBuilder()
.setName("TestAppender")
.build();
listAppender.start();
testLogger.addAppender(listAppender);
// 3. 执行被测方法（注意：需确保 System.getenv("my_id") 有值以触发格式化）
try (MockedStatic<System> systemMock = mockStatic(System.class)) {
systemMock.when(() -> System.getenv("my_id")).thenReturn("test-value");
MyCoreLog.error("error message 2");
}
// 4. 断言捕获的日志
List<LogEvent> events = listAppender.getEvents();
assertThat(events).hasSize(1);
assertThat(events.get(0).getMessage().getFormattedMessage())
.isEqualTo("error message 2, my_id=test-value");
}此方案不依赖静态字段重置，完全基于 Log4j2 的运行时日志路由机制，稳定性更高，也更贴近真实环境。
总结
- ❌ 错误模式：为每个测试创建独立 Logger mock 并期望 MyCoreLog.logger 被重新赋值（不可能，因 static final 初始化仅一次）；
- ✅ 推荐方案：使用 static final mock + reset() + 统一 mockStatic 配置；
- ✅ 进阶方案：弃用 mock，用 ListAppender 直接验证日志输出，消除静态初始化副作用；
- ? 工具提示：启用 -Dlog4j2.debug=true 可观察 Log4j2 日志器解析过程，辅助诊断类加载问题。
