本文详解如何在 junit 5 + mockito 4.11+ 环境下，通过 mockstatic() 动态扩展枚举常量集合，构造非法枚举实例以触发并断言预期异常，避免直接 mock 枚举导致的 cannot mock/spy final classes 错误。
本文详解如何在 junit 5 + mockito 4.11+ 环境下，通过 mockstatic() 动态扩展枚举常量集合，构造非法枚举实例以触发并断言预期异常，避免直接 mock 枚举导致的 cannot mock/spy final classes 错误。
在 Java 中，枚举（enum）本质是 final 类，无法被传统 Mockito mock() 直接模拟——这也是用户原始测试失败的根本原因：mock(Employee.class) 会抛出 MockitoException。但实际测试需求非常合理：需验证工厂方法对未声明枚举值（如 TEACHER）的健壮性，即是否正确抛出 EmployeeException。
正确的解法是利用 Mockito 4.11+ 引入的 静态方法模拟能力（mockStatic），劫持枚举的 values() 方法返回自定义数组，从而“注入”一个逻辑上存在、但源码中未定义的枚举实例。该实例需满足两个关键契约：
- 具备合法的 ordinal() 值（用于 switch 分支匹配校验）；
- 不与现有枚举常量冲突（如 DOCTOR 的 ordinal() 为 0，NURSE 为 1，新实例宜设为 2）。
以下是完整、可运行的测试代码示例：
import org.junit.jupiter.api.Test;
import org.mockito.MockedStatic;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.mockito.Mockito.*;
@Test
void shouldThrowExceptionForInvalidEmployee() {
try (MockedStatic<Employee> employeeMock = mockStatic(Employee.class)) {
// Step 1: 创建一个模拟的非法枚举实例
Employee TEACHER = mock(Employee.class);
when(TEACHER.ordinal()).thenReturn(2); // 关键：设置唯一 ordinal
when(TEACHER.name()).thenReturn("TEACHER"); // 可选：增强可读性
// Step 2: 重写 Employee.values() 返回包含 DOCTOR, NURSE, TEACHER 的数组
employeeMock.when(Employee::values)
.thenReturn(new Employee[]{Employee.DOCTOR, Employee.NURSE, TEACHER});
// Step 3: 执行被测方法并断言异常
assertThrows(EmployeeException.class, () ->
EmployeeFactory.createEmployee(TEACHER)
);
}
}✅ 关键注意事项：
立即学习“Java免费学习笔记（深入）”；
- 必须使用 try-with-resources：MockedStatic 是资源型对象，需确保 close() 被调用以恢复原始 values() 行为，避免污染其他测试；
- ordinal() 必须显式 stub：switch 语句底层依赖 ordinal()，若不设置将返回默认 0，导致误匹配 DOCTOR；
- name() 和 toString() 可按需 stub：虽非必需，但有助于调试时日志清晰；
- 不推荐反射修改 ENUM_CONSTANT_DIRECTORY：该方式破坏封装、易受 JDK 版本影响，且 Mockito 方案更安全、可维护；
- 生产环境慎用此技巧：仅限单元测试场景；枚举设计本意是封闭集合，若频繁需“扩展”，应重新评估是否该用策略模式或接口替代。
总结而言，通过 mockStatic(Employee.class) 控制 values() 的返回值，配合手动构造符合枚举契约的 mock 实例，即可精准覆盖非法输入路径。这既尊重了 Java 枚举的不可变性，又满足了高质量单元测试对边界条件的全覆盖要求。
