SceneKit中didBeginContact碰撞回调重复触发如何解决

这个无限触发回调的问题和SCNAction没有本质关系，核心是对SceneKit物理体类型的使用不符合引擎设计逻辑：

• kinematic（运动学）类型的物理体，物理引擎完全不会对其施加任何碰撞响应、位置修正，它的位置100%由代码控制（SCNAction、直接改position都属于代码硬控位置），引擎只会读取它的位置做碰撞/接触检测，不会阻止它和其他物体穿模。
• didBegin contact的触发规则是：两个物体从「分离状态」第一次进入「接触状态」时触发一次，对应didEnd contact在两个物体从接触变回分离时触发。

你当前场景里两个物体都是kinematic类型，SCNAction持续把移动的平台往静止的球的方向硬推，二者接触穿模后：

1. 因为都是kinematic，引擎不会把两个物体弹开、也不会阻止平台继续往球的内部钻
2. 没有碰撞解算维持稳定的接触状态，引擎每帧都会判定二者是「刚进入接触的新状态」，就会反复触发didBegin回调，直到两个物体彻底分离。

另外当前代码还有两个小问题会放大这个现象：

• 没有判断接触节点的双向顺序，只判断了nodeA是球、nodeB是平台的情况，实际引擎返回的两个节点顺序是不固定的
• 接触触发后没有停止移动动作，任由平台持续穿模

根据需求选对应方案即可：

方案1：调整物理体类型+碰撞后停止动作（推荐） #

这是最符合SceneKit物理引擎设计的用法：

1. 静止的球节点设置为.static（静态）类型，这类物理体会参与碰撞解算，会阻挡kinematic/dynamic类型的物体穿模
2. 移动的平台保持.kinematic类型即可
3. 第一次触发接触回调后，立刻停止平台的移动动作，避免继续穿模
4. 加单次触发标记，兼容极端情况下的重复回调

修正后的核心代码：

// 类中新增标记属性，避免重复处理碰撞
var hasProcessedContact = false

var ballNode : SCNNode!
var referenceNode : SCNReferenceNode!

func setUpNodes(){
    // 重置碰撞标记
    hasProcessedContact = false
    
    ballNode = scene.rootNode.childNode(withName: "ball", recursively: true)
    // 显式设置静止球为静态物理体
    ballNode.physicsBody?.type = .static
    ballNode.physicsBody?.restitution = 0
    
    guard let filePath = Bundle.main.path(forResource: "ledge", ofType: "scn", inDirectory: "art.scnassets") else { return }
    let referenceURL = URL(fileURLWithPath: filePath)
    referenceNode = SCNReferenceNode(url: referenceURL)
    referenceNode!.load()
    referenceNode!.position = SCNVector3(x: 0, y: 0, z: -20)
    referenceNode?.physicsBody?.categoryBitMask = 2
    referenceNode?.physicsBody?.collisionBitMask = 4
    referenceNode?.physicsBody?.contactTestBitMask = 4
    // 显式设置移动平台为运动学物理体
    referenceNode?.physicsBody?.type = .kinematic
    referenceNode?.physicsBody?.restitution = 0
    scene.rootNode.addChildNode(referenceNode!)
    referenceNode!.runAction(SCNAction.move(by: SCNVector3(x: 0, y: 0, z: 30), duration: 6))
}

func physicsWorld(_ world: SCNPhysicsWorld, didBegin contact: SCNPhysicsContact) {
    // 已经处理过碰撞直接返回
    guard !hasProcessedContact else { return }
    
    let nodeA = contact.nodeA
    let nodeB = contact.nodeB
    // 兼容节点顺序互换的情况
    let isBallAndLedgeContact = (nodeA.name == "ball" && nodeB.name == "ledge2") || (nodeA.name == "ledge2" && nodeB.name == "ball")
    guard isBallAndLedgeContact else { return }
    
    hasProcessedContact = true
    print("contact")
    // 立刻停止平台的移动动作，避免继续穿模
    let ledgeNode = nodeA.name == "ledge2" ? nodeA : nodeB
    ledgeNode.removeAllActions()
    
    // 可选：根据contact.contactPoint校正平台位置，彻底消除穿模间隙
}

方案2：保持双kinematic类型+状态拦截 #

如果因为特殊需求必须让两个物体都保持kinematic类型，只需要加碰撞状态标记即可：第一次触发接触后把标记设为true，后续重复触发的回调直接拦截跳过。注意这种方案下需要自己处理两个物体的位置，避免持续穿模。

方案3：替换移动方式 #

不要用SCNAction直接移动带物理体的节点，SCNAction是直接修改节点transform，属于逐帧瞬移，物理引擎对这种移动的连续碰撞检测支持很差。可以在SCNSceneRendererDelegate的renderer(_:updateAtTime:)回调中逐帧修改kinematic物体的physicsBody位置，让引擎能正确跟踪接触状态。

永远不要让两个无碰撞响应的物理体持续重叠穿模，不管是kinematic+kinematic还是kinematic+static的组合，只要硬推物体穿模且不做位置校正，都可能出现接触回调异常的问题。

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