java 对象序列化中检测循环依赖主要依靠 objectoutputstream 内部维护的写对象表（write table）来实现，该机制会自动识别并抛出 circularityexception。具体做法是确保所有参与序列化的类都正确实现了 serializable 接口，并在序列化过程中通过 writereplace 或自定义 writeobject 方法来处理复杂的引用关系，或者在业务逻辑层面预先打破循环。
序列化过程中如何自动检测循环引用
当调用 ObjectOutputStream.writeObject() 时，JVM 会检查当前对象是否已经存在于内部的哈希表中。如果检测到重复的对象引用，即形成了循环依赖，序列化流会立即中断并抛出 java.io.NotSerializableException 或更具体的 java.io.ObjectStreamException 子类异常。这种检测是透明的，开发者无需手动遍历对象图，只需关注异常捕获即可。
import java.io.*;
public class CycleDetector {
public static void main(String[] args) throws Exception {
Node a = new Node("A");
Node b = new Node("B");
a.next = b;
b.next = a; // 形成循环
try (ByteArrayOutputStream baos = new ByteArrayOutputStream();
ObjectOutputStream oos = new ObjectOutputStream(baos)) {
oos.writeObject(a);
} catch (IOException e) {
System.out.println("Detected: " + e.getClass().getSimpleName());
}
}
static class Node implements Serializable {
String name;
Node next;
Node(String n) { name = n; }
}
}
如何通过自定义 writeObject 优化循环检测
如果需要更精细的控制，可以在类中定义 private void writeObject(ObjectOutputStream out) 方法。在此方法中，可以手动检查特定字段是否为 null 或是否指向已序列化的对象。虽然底层依然依赖 Write Table，但自定义逻辑允许我们在抛出异常前进行日志记录或尝试打破循环。例如，可以设置一个标志位来标记当前正在序列化的节点，防止无限递归进入 writeObject 本身。
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
立即学习“Java免费学习笔记（深入）”；
import java.io.*;
public class CustomCycleHandler {
public static void main(String[] args) throws Exception {
Link head = new Link("Head");
Link tail = new Link("Tail");
head.next = tail;
tail.next = head;
try (ByteArrayOutputStream baos = new ByteArrayOutputStream();
ObjectOutputStream oos = new ObjectOutputStream(baos)) {
oos.writeObject(head);
} catch (IOException e) {
System.out.println("Caught: " + e.getMessage());
}
}
static class Link implements Serializable {
String id;
transient Link next;
Link(String i) { id = i; }
private void writeObject(ObjectOutputStream out) throws IOException {
out.defaultWriteObject();
if (next != null && !id.equals(next.id)) {
out.writeObject(next);
}
}
}
}
基于 transient 关键字的循环规避策略
在程序实现中，若某个字段不参与序列化，可以使用 transient 关键字修饰。对于循环依赖中的“回指”链接，通常将其标记为 transient。这样在序列化主路径时，不会跟随该链接去序列化反向对象，从而避免循环。反序列化后，该字段为 null，需要在业务层重新建立连接。这是一种常见的工程实践，用于简化序列化过程并避免深度嵌套带来的性能问题。
