运行时异常是兼容性失效信号，需在反序列化环节主动捕获三类可恢复异常并兜底处理：字段缺失、类型不匹配、枚举值不存在；通过弹性配置ObjectMapper、服务治理联动、可观测闭环实现滚动升级支撑。
运行时异常本身不是保障手段，而是兼容性失效的信号。真正起作用的是在反序列化环节主动捕获、识别并兜底处理不兼容场景，把“抛异常”变成“做兼容”，从而支撑滚动升级。
识别关键异常类型，明确拦截边界
不是所有反序列化异常都值得拦截。重点关注以下三类可恢复、有规律的异常：
-
字段缺失异常：如 Jackson 的
UnrecognizedPropertyException（JSON 多字段）、MismatchedInputException（JSON 少字段但目标字段非 null）；Redis 反序列化中InvalidDefinitionException（新增必填字段未提供） -
类型不匹配异常：如字段原为
String，新版本改为LocalDateTime，但旧数据仍是时间字符串，触发JsonMappingException -
枚举值不存在异常：如 JSON 中含
"status": "PENDING_APPROVAL"，但当前类枚举只定义了PENDING和APPROVED，抛出InvalidFormatException
配置弹性反序列化器，实现自动降级
以 Jackson 为例，在 Spring Boot 中统一配置 ObjectMapper，避免各处零散处理：
- 启用宽松模式：
configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false)——忽略多余字段 - 允许空值赋给基本类型：
configure(DeserializationFeature.ACCEPT_EMPTY_STRING_AS_NULL_OBJECT, true)和configure(DeserializationFeature.ACCEPT_SINGLE_VALUE_AS_ARRAY, true) - 注册自定义反序列化器：对易变字段（如状态、时间）编写容错逻辑，例如将任意字符串转为默认枚举值，或用正则提取时间片段再解析
- 设置默认值策略：
setDefaultSetterInfo(JsonSetter.Value.forValueNulls())，让缺失字段走构造器/Setter 默认逻辑
结合服务治理策略，控制影响范围
单靠序列化层兜底不够，需与发布节奏联动：
- 在 Dubbo 或 Spring Cloud Gateway 层按调用方标识（如
app-versionheader）路由到不同服务实例组，新老版本共存期间，旧客户端始终对接旧服务节点 - 对关键 DTO 类添加运行时版本标记，如
@JsonDeserialize(using = VersionedCustomerDeserializer.class)，反序列化器内根据请求上下文或 payload 特征判断来源版本，执行分支逻辑 - 在网关或 Feign Client 拦截器中预检响应体结构，发现字段差异时自动注入兼容字段或剥离敏感字段，再交由下游反序列化
建立异常可观测闭环，驱动持续优化
把每次兜底行为变成可追踪、可分析的数据点：
- 记录被忽略的未知字段名、被转换的异常枚举值、被填充的默认时间等，打上服务名、接口名、客户端版本标签
- 接入日志告警系统，当某类兼容事件 5 分钟内突增 10 倍，立即通知负责人核查是否误发新包或配置错误
- 定期扫描日志中高频兜底项，推动上游收敛模型变更方式——例如将“新增必填字段”改为“新增可选字段 + 后端默认生成”，从源头减少兼容负担
