RealityKit复用ARView时playAnimation触发内存泄漏如何解决

问题核心原因 #

AnimationLibraryDefinition实例无法释放是RealityKit动画模块的已知资源持有问题，原有清理逻辑失效的原因有三点：

• 调用playAnimation时未持有返回的AnimationPlaybackController，重复动画资源被全局动画缓存隐式持有，无法通过实体方法解除引用
• 仅停止实体动画、置空实体不会清理ARView场景树、渲染会话持有的资源引用，复用ARView的场景下旧资源会持续挂在渲染链路中
• USDZ解析生成的动画库默认存在全局静态缓存引用，仅释放实体不会触发这部分缓存的回收，每次重新加载USDZ都会生成新的动画库实例且无法释放

分步修复方案 #

1. 持有动画播放控制器，补全动画解绑逻辑 #

不要直接在循环中丢弃playAnimation的返回值，用数组存储所有播放控制器，为后续手动解绑做准备：

// 控制器存储属性定义在AR视图控制器的属性区
var animationControllers: [AnimationPlaybackController] = []

// 动画播放逻辑修改
hummingbird = try! Entity.load(named: "bird")
for animation in hummingbird.availableAnimations {
    let repeatAnim = animation.repeat(duration: 120.0)
    let controller = hummingbird.playAnimation(repeatAnim)
    animationControllers.append(controller)
}

2. ARView退出时执行全量资源清理 #

原有清理逻辑覆盖不全，需按以下顺序执行清理，彻底切断资源引用链：

// 先停止所有持有的动画控制器，重置混合参数
animationControllers.forEach {
    $0.stop()
    $0.blendFactor = 0
}
animationControllers.removeAll()

// 清理实体层级资源
hummingbird.stopAllAnimations(recursive: true)
hummingbird.removeFromParent()

// 清理ARView全量场景与渲染资源
arView.scene.anchors.removeAll()
arView.session.pause()
arView.removeFromSuperview()
arView.scene = ARScene() // 重置场景实例，切断旧场景资源引用

// 最后释放实体引用
hummingbird = nil

3. 全局缓存复用资源，从根源避免重复生成动画库 #

如果完成前两步后仍存在泄漏，说明触发了RealityKit全局动画缓存不回收的bug，可通过全局一次性加载资源、场景内复用的方式规避，避免每次进入场景都重新解析USDZ生成新的动画库实例：

// 全局资源单例，仅在应用启动后第一次调用时加载一次
enum SharedARAsset {
    static let birdEntity: Entity? = try? Entity.load(named: "bird")
    static let birdLoopAnimations: [AnimationResource] = {
        guard let bird = birdEntity else { return [] }
        return bird.availableAnimations.map { $0.repeat(duration: 120.0) }
    }()
}

后续进入AR场景时，通过clone(recursive: true)拷贝实体使用，动画直接复用SharedARAsset中预加载的资源即可，不会重复生成AnimationLibraryDefinition实例。

验证标准：反复执行「进入AR页-返回起始页」流程10次以上，用Instruments检测到AnimationLibraryDefinition实例数量稳定不随进入次数线性增长，即为修复生效。

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