iOS RealityKit报错：Attempting to form more than one copy of a bag求解答

错误信息 #

RealityFoundation/OrderedCoatCheckBag.swift:183: Fatal error: Attempting to form more than one copy of a bag. These should be held by at most one reference type.

中文翻译：

RealityFoundation/OrderedCoatCheckBag.swift:183: 致命错误：尝试创建一个bag的多个副本。这类对象最多只能被一个引用类型持有。

解决思路 #

• 检查实体/组件的引用管理：这个错误源于RealityKit内部的OrderedCoatCheckBag（用于追踪组件或实体的引用关系）被多次复制，违反了单引用持有规则。重点排查是否在多个地方保留了同一个Entity、Component或AnchorEntity的强引用，尤其是异步操作、闭包或不同RealityKit场景之间共享实例的场景。
• 禁止手动复制核心对象：不要对RealityKit的核心对象（如实体、组件）调用copy()方法，这类对象设计为单引用持有，复制会触发内部检查报错。如果需要复用结构，应重新创建新实例而非复制现有对象。
• 排查闭包中的引用问题：若在动画回调、异步加载完成回调等闭包中捕获了RealityKit对象，检查是否导致同一对象被多个闭包或持有者保留。可尝试用weak或unowned修饰捕获的对象，打破不必要的强引用链。
• 规范场景加载与卸载逻辑：切换AR场景时，确保旧场景中的实体被彻底移除并清空所有强引用，避免旧实例被新场景意外持有而触发错误。
• 验证组件的实例化规则：自定义RealityKit组件时，确保每个实体拥有独立的组件实例，不要将同一个组件对象添加到多个实体上。

内容的提问来源于stack exchange，提问作者Marcus Raty