重写 toString 时应避免循环引用导致的 StackOverflowError，核心是主动切断引用链：不直接调用关联对象 toString()，改用字段名+哈希值、ID 或名称等简要信息，并可借助 Set 记录已访问对象实现循环检测。
重写 toString 时，若直接调用关联对象的 toString()（尤其是双向引用或循环引用），会触发无限递归，最终抛出 StackOverflowError。核心解决思路是：**不无条件委托，而要主动切断引用链**。
避免直接调用关联对象的 toString()
不要在 toString() 中写类似 otherObj.toString() 或 "" + otherObj 这样的表达式——Java 会自动触发其 toString()，一旦形成环（如 A→B→A），立刻死循环。
- 改用字段名+哈希值形式展示，例如：
"name=" + name + ", department=" + (department != null ? department.getClass().getSimpleName() + "@" + System.identityHashCode(department) : "null") - 对集合类也需谨慎：不调用
list.toString()，而是用list.size()、list.isEmpty()或取前几个元素的简要信息
使用 Objects.toString() 安全代理
java.util.Objects.toString(Object obj) 是空安全的，但注意：它仍会调用 obj.toString() —— 所以它只防 null，不防循环。真正安全的是带默认值的重载：Objects.toString(obj, "null")，但它依然不能阻止非 null 对象内部的死循环。
Java Maven Common
下载
Java Maven 项目审查工作流的通用输入处理。当 Java Maven 项目以 ZIP压缩包或 GitLab 仓库 URL 形式提供且需要...时使用。
- 仅当确认关联对象的
toString()是“无副作用、无循环”的才可放心用 - 更稳妥的做法是：自己控制输出内容，例如只输出 ID、名称等基础字段，而非整个对象
引入打印上下文或深度限制（进阶）
对于复杂嵌套结构（如树、图），可借助临时状态标记已访问对象，防止重复打印：
立即学习“Java免费学习笔记（深入）”；
- 用
ThreadLocal<set>></set>或方法参数传入一个Set<object></object>记录当前打印路径中已出现的对象 - 每次进入关联对象前先检查是否已在集合中；若存在，输出类似
"[CircularRef: User@12345]"而非递归调用 - Spring 的
ToStringCreator和 Apache Commons Lang 的ReflectionToStringBuilder都内置了循环检测逻辑，可参考其实现
推荐实践：只暴露必要字段，明确边界
toString() 的本质是调试辅助，不是数据导出工具。应遵循最小原则：
- 只拼接本类的核心业务字段（如 id、name、status），避开导航属性（如 user.getDepartment()、department.getUsers()）
- 若必须体现关联，用 ID 或名称代替完整对象，例如：
"deptId=" + (department != null ? department.getId() : null) - 在类注释或 Javadoc 中说明该
toString()不包含关联对象详情，避免使用者误解
