java中tostring方法默认不处理循环引用，直接调用会导致无限递归并抛出stackoverflowerror；常见于双向链表、父子树结构、orm级联实体等场景；安全方案包括跳过关联对象、threadlocal记录已遍历对象、使用apache commons lang的循环检测或jackson预处理。
Java 中的 toString 方法默认不会自动检测或处理循环引用，直接调用会导致无限递归，最终抛出 StackOverflowError。
为什么循环引用会引发栈溢出
当对象 A 持有对象 B 的引用，B 又反过来持有 A 的引用，且两者在 toString() 中都尝试打印对方时，就会形成调用链：A.toString → B.toString → A.toString → …，JVM 调用栈持续增长直至溢出。
常见场景示例
比如双向链表节点、父子关系的树结构、ORM 中的级联实体（如 User ↔ Department）等，若 toString 直接拼接关联对象，极易触发该问题。
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 未重写
toString：使用Object.toString()输出哈希码，不触发递归，但信息无意义 - 手动拼接字段（含引用对象）：若未加控制，一调用就崩溃
- 用 Lombok 的
@ToString：默认不递归打印，但可通过exclude或of显式指定字段
安全处理循环引用的几种方式
核心思路是打破递归链，常用做法包括：
- 避免在 toString 中访问可能形成闭环的引用字段：只打印基础属性（id、name 等），跳过关联对象或仅打印其 id
-
使用 ThreadLocal 记录已遍历对象：在
toString开始时检查当前对象是否已在调用栈中出现过，是则返回占位符（如"[CircularRef]"） -
借助第三方库：如 Apache Commons Lang 的
ReflectionToStringBuilder支持循环引用检测（设置setCycleDetectionEnabled(true)） -
序列化前预处理：调试时可用 Jackson 的
ObjectMapper配合SimpleModule自定义序列化器，跳过或标记循环引用
一个轻量级防护示例
用 IdentityHashMap 跟踪递归深度（注意：仅限调试或低频调用场景，生产慎用）：
private static final ThreadLocal<identityhashmap void>> seen =
ThreadLocal.withInitial(IdentityHashMap::new);
public String toString() {
IdentityHashMap<object void> map = seen.get();
if (map.containsKey(this)) {
return getClass().getSimpleName() + "@" + Integer.toHexString(System.identityHashCode(this));
}
map.put(this, null);
try {
return String.format("%s{id=%d, name='%s', parent=%s}",
getClass().getSimpleName(), id, name, parent);
} finally {
map.remove(this);
if (map.isEmpty()) seen.remove();
}
}
</object></identityhashmap>
不复杂但容易忽略Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
