本文介绍在使用 SnakeYAML 处理含锚点（&id）和别名（*id）的 YAML 配置文件时，因自引用导致构造 Configuration 对象时发生无限循环的问题，并提供安全、健壮的递归解析方案。
本文介绍在使用 snakeyaml 处理含锚点（`&id`）和别名（`*id`）的 yaml 配置文件时，因自引用导致构造 `configuration` 对象时发生无限循环的问题，并提供安全、健壮的递归解析方案。
YAML 支持锚点（&id）和别名（*id）机制，用于复用数据结构。但当别名指向其自身或父级结构（如示例中 minerate-full-mined: *id001 指向根锚点 &id001），SnakeYAML 在解析后会将该字段值设为对当前 Map 的循环引用（例如 toString() 输出为 "playername=SomeName, lang=fr_FR, minerate-full-mined=(this Map)"）。若在自定义 Configuration 构造逻辑中不加判断地递归构建嵌套实例，就会触发无限递归，最终导致 StackOverflowError。
核心问题在于：entry.getValue() 返回的并非普通 Map，而是 SnakeYAML 内部包装的、持有循环引用的代理对象（SafeConstructor.ConstructedObject 或类似实现）。直接调用 toString() 是一种轻量级检测手段，但更可靠的方式是结合 IdentityHashMap 进行引用级判重。不过，针对本场景的简洁实用解法如下：
public Configuration(File file, Map, ?> map, Configuration defaults) {
this.file = file;
this.self = new LinkedHashMap();
this.defaults = defaults;
// 使用 IdentityHashMap 记录已处理的原始 Map 引用，防止重复解析同一对象
Set<map>> seenMaps = Collections.newSetFromMap(new IdentityHashMap());
for (Map.Entry, ?> entry : map.entrySet()) {
String key = (entry.getKey() == null) ? "null" : entry.getKey().toString();
Object value = entry.getValue();
if (value instanceof Map && !seenMaps.contains(value)) {
seenMaps.add((Map, ?>) value);
Configuration nextDef = (defaults == null) ? null : defaults.getSection(key);
// 关键：避免将当前 Configuration 作为默认值传入自身子节点（防环）
this.self.put(key, new Configuration(file, (Map, ?>) value,
nextDef == this ? null : nextDef));
} else if (value instanceof Map) {
// 已见过该 Map → 跳过递归，保留原始引用（或存为占位符）
this.self.put(key, value); // 或设为 null / new RecursiveReference(key)
} else {
this.self.put(key, value);
}
}
}</map>
⚠️ 注意事项：
- 不应依赖 toString() 字符串匹配（如 "(this Map)"），因其属于 SnakeYAML 内部调试输出，不具备 API 稳定性，可能随版本变更而失效；
- IdentityHashMap 是检测循环引用的黄金标准，它基于内存地址而非 equals() 判断，精准识别同一对象多次出现；
- 若业务需保留别名语义（如运行时动态解析 *id001），应在 Configuration 中增加惰性解析层（如 getResolvedValue(String key)），而非在构造期强行展开；
- SnakeYAML 3.0+ 提供了 Construct 和 Representer 的更细粒度控制，可考虑升级并使用 CustomClassLoaderConstructor 避免反射陷阱。
总结：解决 YAML 自引用导致的无限循环，关键在于构造期引用去重 + 默认值隔离。通过 IdentityHashMap 实现 O(1) 引用检测，并严格约束 defaults 参数传递链，即可在保持配置灵活性的同时杜绝栈溢出风险。
