Java对象图序列化关键在于明确控制引用语义和结构边界，需识别循环引用、按需裁剪嵌套深度、谨慎处理泛型类型，并依场景选Jackson/Hessian/XStream等合适工具。
Java 中对象图复杂嵌套的正确序列化，关键不在“避开循环”，而在于**明确控制引用语义和结构边界**。直接用默认方式（如 Jackson 或 Gson 的基础配置）容易触发栈溢出、无限递归，或生成冗余、不可控的 JSON/XML。真正可靠的做法是结合工具特性做有意识的干预。
识别并标记循环引用节点
很多问题其实源于没意识到对象图里存在隐式循环——比如父子双向关联、树形结构带 parent 字段、或者 ORM 实体间级联关系。先用调试或日志打印对象图结构，确认哪些字段实际构成了闭环。一旦定位，可采用以下任一方式显式处理：
- 在字段上加
@JsonIgnore（Jackson）或@Expose(serialize = false)（Gson），切断默认遍历路径 - 对实体类统一实现
java.io.Serializable并定义serialVersionUID，为后续反序列化兼容留余地 - 使用
@JsonIdentityInfo（Jackson）或GraphAdapterBuilder（Gson）启用 ID 引用模式：首次出现时完整输出，后续仅输出 ID，从根本上避免重复嵌套
按业务意图决定嵌套深度与粒度
不是所有嵌套都需要展开。例如订单对象含用户、地址、商品列表，但 API 只需返回用户昵称和商品名称，就不该把整个 User 对象或 Address 的全部字段序列化进去。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 用
@JsonView定义视图接口，配合 Controller 层选择性暴露字段 - 对嵌套对象单独写
JsonSerializer，将其序列化为字符串（如"detail": "{\"price\":99.9,\"stock\":5}"），适用于需透传原始 JSON 字符串的场景 - 借助 DTO 手动投影，只封装当前接口需要的字段，彻底脱离原始对象图结构
谨慎使用泛型与动态类型
泛型嵌套（如 Response）本身不构成问题，但 Jackson 默认无法推断运行时类型。若反序列化失败或字段为空，大概率是类型擦除导致的类型丢失。>
- 反序列化时必须传入
TypeReference，如objectMapper.readValue(json, new TypeReference>() {}) - 避免在泛型参数中混用通配符（
?）或原始类型，会进一步加剧类型推断失效 - 对第三方库引入的嵌套类型（如
LocalizedTexts），优先用@JsonSerialize(using = ...)+ 自定义 Converter 统一扁平化，而不是强行适配其原始结构
选对工具，别强求“通用”
不同场景适合不同序列化器：
- 纯 Java 内部通信、RPC（如 Dubbo）：Hessian 更稳，原生支持循环引用、多态、泛型，且二进制体积小
- 对外 REST API：Jackson 是事实标准，配合模块（jackson-datatype-jsr310、jackson-datatype-jdk8）能很好处理时间、Optional 等现代类型
- 需与遗留系统交换 XML：XStream 支持无参构造、私有字段、复杂继承，无需修改源码即可工作
- 极简配置需求或调试查看：Gson 上手最快，但默认不处理循环，需手动集成
GraphAdapterBuilder
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
