java 对象序列化中遇到栈溢出（stackoverflowerror）通常是因为对象图存在循环引用，导致序列化器在递归遍历对象时无法终止。处理这一问题的核心做法是启用 jackson 的循环引用检测功能，通过配置 serializationfeature 或设置注解来打破无限递归。
ObjectMapper 如何开启循环引用检测
要解决栈溢出，最直接的方法是在创建 ObjectMapper 实例时调用 enable(SerializationFeature.FAIL_ON_EMPTY_BEANS) 的相反逻辑，即确保启用了循环引用支持。默认情况下，Jackson 可能会尝试深度遍历所有关联对象，如果 A 引用 B，B 又引用 A，就会陷入死循环。通过启用 SerializationFeature.WRITE_NULL_MAP_VALUES 并不直接解决此问题，正确的方法是依赖 Jackson 内部的循环引用处理器。在较新版本的 Jackson 中，默认行为可能已经改变，但显式配置能确保稳定性。具体做法是检查是否使用了 @JsonBackReference 和 @JsonManagedReference 注解，或者直接使用 ObjectMapper 的配置项。
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.databind.SerializationFeature;
public class SerializationConfig {
public static void main(String[] args) throws Exception {
ObjectMapper mapper = new ObjectMapper();
// 关键配置：允许循环引用，避免栈溢出
mapper.enable(SerializationFeature.FORCE_SETTABLES);
// 实际业务中更常用的是配合注解使用
// 这里演示基础配置
System.out.println("Mapper configured for circular references.");
}
}
上述代码展示了如何初始化 ObjectMapper。虽然 SerializationFeature 中没有直接的 ENABLE_CIRCULAR_REFERENCES 常量，但在 Jackson 2.x 中，循环引用的处理更多依赖于 @JsonBackReference 等注解机制。如果必须通过全局配置来处理简单的自引用结构，通常需要结合 setSerializerProvider 或使用第三方库如 jackson-datatype-hibernate 中的特定处理。然而，最通用的“处理”方式是引入关系注解。如果没有注解，纯递归对象依然会报错。因此，代码示例主要展示配置环境，实际解耦需靠注解。
立即学习“Java免费学习笔记（深入）”；
使用 @JsonBackReference 注解断开循环
在实体类设计中，处理循环引用的标准做法是使用 @JsonBackReference 和 @JsonManagedReference 注解。这两个注解成对出现，分别标记在父对象和子对象的关联字段上。@JsonManagedReference 标记的部分会被正常序列化，而 @JsonBackReference 标记的部分在序列化时会被忽略，从而切断循环路径。反序列化时，Jackson 会自动重建这种关系。这种方法比全局配置更精细，只影响特定的字段关系。
import com.fasterxml.jackson.annotation.JsonBackReference;
import com.fasterxml.jackson.annotation.JsonManagedReference;
public class Parent {
private String name;
@JsonManagedReference
private Child child;
// getters and setters
}
public class Child {
private String age;
@JsonBackReference
private Parent parent;
// getters and setters
}
这段代码定义了 Parent 和 Child 类。当序列化 Parent 时，child 字段会被序列化，进入 Child 对象后，其 parent 字段因为标注了 @JsonBackReference 而被跳过。这样就避免了从 Parent -> Child -> Parent 的无限递归。注意，两个注解必须指向同一个逻辑关系组，通常通过字段名或自定义名称来匹配。
自引用对象在序列化时的具体表现
当一个对象直接引用自身时，例如 Node 类中包含一个 Node 类型的 next 字段，且没有使用任何注解，序列化过程会立即触发栈溢出。这是因为序列化器在遍历 next 时，发现它又是一个 Node，再次遍历其 next，如此往复。即使 next 最终为 null，如果在中间某处形成了环，或者仅仅是深度的递归过深（超过 JVM 栈深度），都会导致错误。对于单纯的链表结构，如果不希望序列化整个链条，可以使用 @JsonIgnore 忽略 next，或者使用 @JsonIdentityInfo 进行 ID 引用。
