如何限制Jackson序列化任意Java对象的深度 避免递归引发无限JSON问题

方案1：基于遍历深度限制实现 #

• 序列化过程中为每个层级的遍历维护一个深度计数器，初始值为0，每向下嵌套一层对象/字段就将计数器+1
• 提前预设最大序列化深度（可支持用户自定义配置），当计数器达到阈值时，直接返回预设的占位符（比如"[MAX_DEPTH_REACHED]"或者对象的toString()结果）即可终止嵌套
• 实现注意点：需要为每个序列化的根对象单独维护深度计数，避免多线程序列化时计数串掉

方案2：基于已遍历对象引用去重实现 #

• 序列化过程中维护一个线程安全的对象引用集合，存储已经处理过的对象内存地址
• 每次处理一个对象前先检查该引用是否已经存在于集合中：如果存在，直接返回占位符（比如"[CIRCULAR_REFERENCE]"）；如果不存在，将引用加入集合后再继续序列化
• 实现注意点：避免误判内容相同但内存地址不同的对象为循环引用，不要用对象equals()判断，必须用原生的引用地址比对，Java里可以用System.identityHashCode()辅助判断或者直接存储引用到IdentityHashMap里

方案3：混合深度+引用去重实现（更适合日志场景） #

• 同时开启深度限制和引用去重两个检查逻辑，任意一个触发阈值就终止嵌套
• 可以针对不同类型的对象做差异化配置：比如集合类型单独设置最大嵌套深度，避免大集合打满日志内容
• 日志场景下可以额外做裁剪：比如超出限制的字段直接丢弃，或者只输出基础类型字段，忽略自定义对象类型

适配优化建议 #

如果你的日志库是基于Jackson/Gson二次封装的，不需要等框架内置对应功能，完全可以自定义序列化器实现上述逻辑：

• Jackson可以自定义StdSerializer，在序列化方法内维护深度和引用去重逻辑
• Gson可以自定义TypeAdapter，在write方法中加入上述校验逻辑
• 如果是自研序列化框架，在字段递归遍历的入口统一加上校验逻辑即可，不需要修改每个类型的序列化实现

内容的提问来源于stack exchange，提问作者Kuan B