SwiftUI内容变更导致RealityKit（UIViewRepresentable）冻结问题排查

数据老陈

2026-6-12

问题原因与解决方法

问题根源

RealityKit的ARView渲染与SwiftUI视图更新共享主线程，但两者的调度逻辑存在冲突：

当SwiftUI的@State/@Published变量同步变更时，会立即触发视图树的重计算与更新，这个过程会抢占主线程资源，打断ARView的连续渲染循环，导致场景冻结。
SceneEvents.Update的订阅闭包本身运行在ARView的渲染主线程中，在这个闭包里同步修改@Published变量，会直接引发SwiftUI更新流程与AR渲染流程的竞态，阻塞ARView的帧刷新，最终出现场景卡死。

解决方法

1. 手势修改`@State`的场景

避免在手势回调中直接同步修改@State，改用异步方式更新变量，给AR渲染留出主线程资源：

// 错误示例（会触发冻结）
.gesture(
    MagnificationGesture()
        .onChanged { scale in
            self.currentScale = scale // 直接同步修改@State
        }
)

// 正确示例
.gesture(
    MagnificationGesture()
        .onChanged { scale in
            DispatchQueue.main.async {
                self.currentScale = scale // 异步延迟更新
            }
        }
)

也可以将缩放逻辑转移到UIViewRepresentable的协调器中处理，通过绑定关系同步到SwiftUI，减少直接的主线程冲突。

2. `SceneEvents.Update`中修改`@Published`的场景

绝对不能在AR渲染循环的闭包内同步修改SwiftUI的发布者变量，必须通过异步线程切换来规避竞态：

// 错误示例（会触发冻结）
arView.scene.subscribe(to: SceneEvents.Update.self) { _ in
    self.viewModel.somePublishedValue = newValue // 同步修改@Published
}

// 正确示例
arView.scene.subscribe(to: SceneEvents.Update.self) { _ in
    DispatchQueue.main.async {
        self.viewModel.somePublishedValue = newValue // 异步更新
    }
}

如果使用Combine框架，也可以通过receive(on: DispatchQueue.main)切换到主线程后再更新发布者，效果一致。