java 原生序列化默认不支持循环引用,直接处理会抛出 circularityexception。要解决这个问题,必须使用支持对象引用的序列化框架,如 kryo、hessian 或 jackson(配合 @jsonidentityinfo),或者在 java 原生序列化中通过自定义 writereplace 和 readresolve 方法手动打破循环。

Kryo 如何处理循环引用
Kryo 通过内部维护一个对象 ID 映射表来解决循环引用。当序列化遇到已见过的对象时,它不会再次写入完整数据,而是写入该对象的 ID 引用。这使得 Kryo 能够高效地处理复杂的图结构。

import com.esotericsoftware.kryo.Kryo;
import com.esotericsoftware.kryo.io.Input;
import com.esotericsoftware.kryo.io.Output;
public class KryoCircularRefExample {
public static void main(String[] args) {
Kryo kryo = new Kryo();
// 设置引用跟踪,Kryo 默认开启
kryo.setReferences(true);
Node root = new Node("root");
Node child = new Node("child");
root.next = child;
child.next = root; // 循环引用
Output output = new Output(System.out);
kryo.writeObject(output, root);
output.close();
}
static class Node {
String name;
Node next;
Node(String name) { this.name = name; }
}
}
Hessian 如何处理循环引用
Hessian 同样采用对象引用机制。它在序列化流中为每个唯一对象分配一个句柄(Handle)。当遇到循环引用时,它发送一个指向之前已序列化对象的句柄,而不是重新序列化整个对象图。这种方式使得 Hessian 在处理远程调用中的复杂对象图时非常稳健。

import com.caucho.hessian.io.Hessian2Output;
import com.caucho.hessian.io.Hessian2Input;
import java.io.ByteArrayOutputStream;
import java.io.ByteArrayInputStream;
public class HessianCircularRefExample {
public static void main(String[] args) throws Exception {
Node root = new Node("root");
Node child = new Node("child");
root.child = child;
child.child = root; // 循环引用
ByteArrayOutputStream baos = new ByteArrayOutputStream();
Hessian2Output h2o = new Hessian2Output(baos);
h2o.writeObject(root);
h2o.close();
ByteArrayInputStream bais = new ByteArrayInputStream(baos.toByteArray());
Hessian2Input h2i = new Hessian2Input(bais);
Node deserializedRoot = (Node) h2i.readObject();
System.out.println(deserializedRoot == deserializedRoot.child.child); // true
}
static class Node {
String name;
Node child;
Node(String name) { this.name = name; }
}
}
Jackson 如何使用 @JsonIdentityInfo 处理循环引用
Jackson 默认也会因循环引用导致栈溢出。通过在类上添加 @JsonIdentityInfo 注解,可以指定一个生成器(如 ObjectIdGenerators.PropertyGenerator)来识别对象身份。序列化时,循环引用会被替换为一个 ID 引用,反序列化时再根据 ID 恢复引用关系。
import com.fasterxml.jackson.annotation.JsonIdentityInfo;
import com.fasterxml.jackson.annotation.ObjectIdGenerators;
import com.fasterxml.jackson.databind.ObjectMapper;
@JsonIdentityInfo(generator = ObjectIdGenerators.PropertyGenerator.class, property = "id")
static class TreeNode {
int id;
String value;
TreeNode left;
TreeNode right;
TreeNode(int id, String value) {
this.id = id;
this.value = value;
}
}
// 使用示例
ObjectMapper mapper = new ObjectMapper();
TreeNode root = new TreeNode(1, "root");
TreeNode left = new TreeNode(2, "left");
root.left = left;
root.right = left; // 循环引用
String json = mapper.writeValueAsString(root); // 输出包含 $id 字段
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











