Java中EnumConstantNotPresentException枚举缺失非受检异常-java教程-PHP中文网

enumconstantnotpresentexception是runtimeexception子类，因运行时访问已删除/重命名的枚举常量触发，常见于反序列化、反射或跨版本类加载场景；应避免直接使用enum.valueof()，改用安全查找、兜底默认值、保留废弃常量或改用json等可扩展序列化方式。

java中enumconstantnotpresentexception枚举缺失非受检异常

EnumConstantNotPresentException 是 Java 中一个 非受检异常（RuntimeException 子类），它在运行时发生，表示代码试图访问某个枚举类型中 已不存在的枚举常量。典型场景是：序列化/反序列化、反射调用、或跨版本类加载时，枚举定义发生了变更（比如删除了某个常量），但旧数据或旧字节码仍尝试引用它。

为什么会抛出这个异常

Java 枚举在编译后生成 final 类，每个枚举常量是该类的 static 实例字段。如果某段代码（如反序列化的字节流、反射获取的 name 字符串、或通过 ClassLoader 加载的旧版本类）试图通过名称查找一个枚举常量，而当前枚举类中已没有同名的常量，JVM 就会抛出 EnumConstantNotPresentException。

Java Maven Common

Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。

下载

常见于使用 Enum.valueOf(Class, String) 或 Enum.valueOf(String) 方法时传入了不存在的名称
Java 序列化机制在反序列化枚举对象时，若字段名在当前类中找不到对应常量，也会触发该异常
使用反射（如 Class.getEnumConstants() 配合字符串匹配）且未做存在性校验时容易暴露问题

如何避免和处理

这不是需要“捕获并吞掉”的异常，而是应从设计和兼容性层面预防。核心原则是：枚举一旦发布，不建议删除已有常量；若必须变更，需配套迁移策略。

枚举常量应视为稳定 API，删除前考虑用 @Deprecated 标记，并保留其定义（即使逻辑上不再使用）
替代 Enum.valueOf() 的安全写法：用 Stream.of(MyEnum.values()).filter(e -> e.name().equals(str)).findFirst()，返回 Optional，可优雅处理缺失情况
反序列化场景下，可自定义 readObject 或使用 Jackson/Gson 等库的反序列化配置（如 Jackson 的 @JsonCreator + 构造器兜底逻辑）来容错
若依赖外部输入（如配置文件、HTTP 参数）映射枚举，务必先校验字符串是否为合法枚举 name，再转换

与 IllegalArgumentException 的区别

两者都可能在枚举转换失败时出现，但语义不同：
IllegalArgumentException 多见于 Enum.valueOf() 传入 null 或空字符串等非法参数；
而 EnumConstantNotPresentException 明确表示“名称有效、语法正确，但该常量在当前类中已不存在”。
JVM 抛出后者时，会附带枚举类型和缺失的常量名，便于定位问题根源。