Swift ARKit项目报错：非隔离上下文调用主Actor隔离方法的解决办法

错误原因 #

你的AppModel类被@MainActor标记，这会让类内所有成员默认隔离到主执行上下文（Main Actor）。但你给ARSessionDelegate的session(_:didAdd:)方法添加了nonisolated修饰，导致该方法在非主Actor的上下文执行，无法直接同步调用主Actor隔离的createSphereEntity方法，从而触发报错。

解决方案 #

推荐两种可行的修复方式，优先选择第一种：

方案一：移除代理方法的nonisolated修饰

ARSessionDelegate的回调本身可以安全地在主Actor执行，且RealityKit的场景操作（如添加Entity）必须在主线程完成，因此直接去掉nonisolated是最合理的做法：

// 移除nonisolated修饰，让方法继承类的@MainActor隔离
func session(_ session: ARSession, didAdd anchors: [ARAnchor]) {
    let sphere = createSphereEntity(radius: 0.1)
    // 将小球绑定到每个检测到的锚点
    for anchor in anchors {
        let anchorEntity = AnchorEntity(anchor: anchor)
        anchorEntity.addChild(sphere.clone(recursive: true)) // 克隆实体，避免同一实例重复添加
        arView.scene.addAnchor(anchorEntity)
    }
}

注意：如果要给多个锚点添加小球，必须调用clone(recursive: true)创建实体副本，同一个Entity实例无法被添加到多个父节点下。

方案二：在非隔离方法内切换到主Actor上下文（特殊场景用）

如果因特殊需求必须保留nonisolated修饰，可以通过Task包裹主Actor代码块，强制切换到主执行上下文：

nonisolated func session(_ session: ARSession, didAdd anchors: [ARAnchor]) {
    Task { @MainActor in
        let sphere = createSphereEntity(radius: 0.1)
        for anchor in anchors {
            let anchorEntity = AnchorEntity(anchor: anchor)
            anchorEntity.addChild(sphere.clone(recursive: true))
            arView.scene.addAnchor(anchorEntity)
        }
    }
}

额外提示 #

RealityKit的所有场景修改操作（包括创建ModelEntity、添加到场景、修改实体属性）都必须在主线程/主Actor执行，确保相关代码始终在主上下文运行是避免类似错误的关键。

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