EnumConstantNotPresentException是运行时因类版本不一致导致反序列化失败的异常，根源是旧数据含已删除枚举项；可通过自定义反序列化器兜底或改用@JsonValue/@JsonCreator绑定code字段解决。
EnumConstantNotPresentException 是序列化/反射时找不到枚举常量
这个异常不是编译期报错，而是运行时抛出的——典型场景是：旧版本序列化的对象（比如存 Redis、数据库或文件里）含某个枚举项，新版本代码里删掉了它；反序列化时 JVM 找不到那个 enum 常量，就炸了。
根本原因不是“枚举写错了”，而是类版本不一致导致的反序列化失败。Java 的 Enum 序列化机制会把常量名当字符串存，反序列化时直接用 Enum.valueOf() 查，查不到就抛 EnumConstantNotPresentException。
反序列化前拦截缺失枚举项（最常用且安全）
别等 ObjectInputStream 或 JSON 库自己崩，主动兜底。比如用 Jackson 时，通过自定义 JsonDeserializer 捕获异常并 fallback：
public class SafeEnumDeserializer<T extends Enum<T>> extends JsonDeserializer<T> {
private final Class<T> enumType;
public SafeEnumDeserializer(Class<T> enumType) {
this.enumType = enumType;
}
@Override
public T deserialize(JsonParser p, DeserializationContext ctx) throws IOException {
String value = p.getText();
try {
return Enum.valueOf(enumType, value);
} catch (IllegalArgumentException e) {
// 返回默认值，或 null，或记录告警
return null; // 或枚举里的 UNKNOWN / DEFAULT 常量
}
}
}
- 必须注册到
ObjectMapper：用SimpleModule.addDeserializer() - 不要在
deserialize()里 throw 新异常，否则问题照旧 - fallback 值得选一个语义明确的枚举项（如
UNKNOWN），别用null后续空指针
用 @JsonValue + @JsonCreator 避免依赖枚举名
如果能改枚举定义，比兜底更彻底：把序列化/反序列化逻辑从“枚举名字符串”切换成“整数或自定义 code 字段”，这样删常量不影响旧数据解析。
立即学习“Java免费学习笔记（深入）”；
示例：
public enum Status {
PENDING(1),
DONE(2);
// 删掉 DEPRECATED(3) 不影响老数据
private final int code;
Status(int code) { this.code = code; }
@JsonValue
public int getCode() { return code; }
@JsonCreator
public static Status fromCode(int code) {
for (Status s : Status.values()) {
if (s.code == code) return s;
}
return PENDING; // fallback
}
}
-
@JsonValue控制序列化输出，@JsonCreator控制反序列化入口 - 字段类型得是基础类型（
int/String），不能是复杂对象 - 注意兼容性：旧数据里如果存的是字符串名（如
"DEPRECATED"），这种方案不生效，得先统一序列化格式
ProtoBuf / Avro 等二进制协议更抗删枚举项
JSON/XML 这类文本协议靠名字匹配，天然怕删枚举；而 ProtoBuf 默认用序号（1, 2…）标识枚举项，只要不重排、不复用序号，删中间项不影响解析。
- ProtoBuf 中删枚举项要加
reserved（如reserved 3;），防止后续误用该序号 - Avro 也类似，靠 schema evolution 规则处理缺失字段，但要求 writer schema 和 reader schema 兼容
- 代价是调试困难——你看到的是数字，不是语义名；日志和排查时得多一层映射
删枚举项本身不危险，危险的是没管好上下游的数据契约。老数据、缓存、日志、监控埋点，都可能还带着那个被删的常量——它不在代码里了，但还在世界的某个角落活着。
