Java中不应直接用Object接收异构JSON，而应采用泛型+多态+TypeReference精准反序列化、JsonNode安全路由、以及契约式DTO设计。
Java 中直接用 Object 类接收多层微服务间传输的异构 JSON 并不可取——它不提供类型安全、无法自动反序列化嵌套结构、丢失字段语义，且在跨服务调用中极易引发运行时 ClassCastException 或空指针。真正可行的方案是**放弃裸 Object，转而用泛型 + 多态机制 + 运行时类型信息**构建可识别、可路由、可校验的接收层。
用 TypeReference 绕过泛型擦除，精准接收嵌套结构
微服务 A 发送 {"data":{"user":{"id":101,"type":"vip"},"orders":[{"sn":"O001"}]}}，服务 B 若写 objectMapper.readValue(json, Object.class)，得到的只是嵌套的 LinkedHashMap，后续取 data.user.id 需手动强转、层层判空。
正确做法是按实际结构声明泛型类型：
- 单层对象：直接传
User.class，objectMapper.readValue(json, User.class) - 带通用包装的响应体：
ApiResponse<User>，配合@JsonTypeInfo处理子类型 - 动态嵌套集合：
objectMapper.readValue(json, new TypeReference<ApiResponse<List<Order>>>() {})
用 @JsonTypeInfo + @JsonSubTypes 实现运行时多态分发
当同一接口需接收多种业务实体（如 PayEvent、RefundEvent、CancelEvent），且前端只传一个 JSON 字符串，靠 if-else 判断 type 字段再手动解析，会随业务膨胀而失控。
立即学习“Java免费学习笔记（深入）”；
标准解法是在基类上声明多态策略：
- 定义抽象事件基类：
abstract class Event { String eventId; String timestamp; } - 标注识别字段：
@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.PROPERTY, property = "event_type") - 注册子类映射：
@JsonSubTypes({@Type(value = PayEvent.class, name = "pay"), @Type(value = RefundEvent.class, name = "refund")}) - 接收时统一用：
objectMapper.readValue(json, Event.class)，Jackson 自动选型并实例化
对完全未知结构，用 JsonNode + 路由规则替代 Object
网关或协议适配层确实可能收到任意结构 JSON（如设备原始上报、第三方 webhook）。此时不该用 Object，而应选用 Jackson 的 JsonNode —— 它是只读、零拷贝、支持路径查询的轻量树形结构。
- 接收：
JsonNode root = objectMapper.readTree(json) - 安全提取：
String type = root.path("header").path("type").asText()（不会抛 NPE） - 结合业务规则路由：
if ("sensor_temp".equals(type)) → 转给 TempNormalizer；if ("alarm_vibration".equals(type)) → 转给 VibrationRouter - 必要时再将子节点转为具体 POJO：
mapper.treeToValue(root.path("payload"), TemperatureData.class)
避免在 Controller 层裸用 Object 接收，强制约定契约
Spring Boot 中写 @RequestBody Object dto 是反模式。它让接口失去 OpenAPI 文档能力、IDE 无提示、单元测试难覆盖。
- 所有对外 API 必须定义明确的 DTO 类，哪怕初始只有
Map<String, Object> payload字段 - 对历史遗留“万能参数”接口，用
@JsonAlias兼容多版本字段名，用@JsonIgnoreProperties(ignoreUnknown = true)容忍新增字段 - 网关层做预处理：统一添加
service_id、trace_id、version等元字段，下游服务即可基于这些字段做多态路由
