SpriteKit中SKAction.move驱动相机时偶发崩溃问题求助

根据你提供的崩溃日志和代码，这个偶发崩溃的根源是SpriteKit节点操作的线程安全问题，以及短时间内大量Action堆积导致的内部数据结构损坏，以下是具体的修复方案：

核心问题分析 #

崩溃栈显示异常发生在-[SKNode _runAction:]内部的数组插入操作，错误index 1 beyond bounds for empty array说明SpriteKit管理Action的内部数组在并发操作下被破坏了。结合你的代码场景：

• animateCamera是在ARKit的renderer(_:updateAtTime:)回调中调用的，这个回调运行在SceneKit的后台渲染队列，而非主线程
• SpriteKit的所有节点API（包括runAction）都不是线程安全的，跨线程操作会导致内部数据结构（比如Action队列）的不一致，进而触发偶发的数组越界

另外，你每次调用animateCamera都会创建一个新的SKAction.move(to:)并执行，而这个Action的duration只有0.005（几乎瞬间完成），短时间内大量触发会导致SpriteKit的Action队列出现冲突，也是偶发崩溃的诱因。

修复方案 #

1. 强制在主线程执行SpriteKit操作 #

所有SpriteKit节点的修改（包括运行Action）必须放在主线程，修改animateCamera的最后一段代码：

let xPosition: Double = Double(x * 19300 * 0.375)
let point = CGPoint(x: xPosition, y: yPosition)
let moveToAction = SKAction.move(to: point, duration: 0.005)

// 切换到主线程执行Action
DispatchQueue.main.async { [weak self] in
    self?.camera?.run(moveToAction)
}

2. 避免Action堆积：用Key覆盖重复Action #

如果连续触发animateCamera，之前的Action可能还没完成就被新的Action叠加，导致内部队列混乱。可以给Action设置唯一Key，新的Action会自动替换旧的：

DispatchQueue.main.async { [weak self] in
    self?.camera?.run(moveToAction, withKey: "cameraPan")
}

3. 替代方案：直接平滑更新位置（无Action） #

如果不想依赖SKAction，也可以通过插值直接更新位置，同样能达到平滑效果，还能避免Action相关的底层问题：

let xPosition: Double = Double(x * 19300 * 0.375)
let targetPoint = CGPoint(x: xPosition, y: yPosition)

DispatchQueue.main.async { [weak self] in
    guard let self = self, let cameraNode = self.cameraNode else { return }
    // 用插值实现平滑移动，调整系数0.1可以控制平滑度
    cameraNode.position = CGPoint(
        x: cameraNode.position.x * 0.9 + targetPoint.x * 0.1,
        y: cameraNode.position.y * 0.9 + targetPoint.y * 0.1
    )
}

4. 防止场景重置时的并发冲突 #

在setupScene执行期间，可能会重置camera节点和场景结构，此时如果animateCamera被调用，会导致节点状态不一致。可以添加一个标志位控制：

// 在NoteScene中添加一个状态变量
private var isSettingUpScene = false

func setupScene(scale: String, root: String) {
    isSettingUpScene = true
    defer { isSettingUpScene = false }
    
    // 原setupScene代码...
}

func animateCamera(xMovement: Float) {
    guard !isSettingUpScene else { return }
    
    // 原animateCamera代码...
}

验证建议 #

• 先尝试主线程执行的修复，这是最可能解决偶发崩溃的核心措施
• 如果问题仍然存在，结合Action Key或直接更新位置的方案，减少Action的使用

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