SceneKit物理系统下阻止物体穿透其他对象的配置问题排查

你配置的物理体无法产生碰撞阻挡的核心原因是碰撞位掩码（collisionBitMask）配置错误，加上物理属性赋值顺序颠倒、平面物理形状无厚度两个附加问题，最终导致盒子直接穿透平面下落。

SceneKit物理引擎的碰撞规则非常明确：

• contactTestBitMask只控制是否触发接触检测回调，不会产生物理阻挡效果
• 两个物体能产生物理碰撞、互相阻挡的前提是：A物体的categoryBitMask 和 B物体的collisionBitMask 做按位与运算结果不为0，反之亦然
• 你给盒子和平面的collisionBitMask都设置为0，按位与运算永远结果为0，等于告诉物理引擎「这两个物体不需要和任何对象做碰撞阻挡解算」，自然会直接穿透。你在接触回调里改重力、改物理体类型、清空速度都属于事后补救，物理引擎从一开始就没计算碰撞阻挡，这些操作自然不会生效。

• 物理属性赋值顺序颠倒：你在盒子、平面的physicsBody还没初始化（为nil）的时候，就通过可选链给isAffectedByGravity、friction等属性赋值，这些语句会直接跳过不执行，等于白写，后续初始化物理体后这些属性用的都是默认值。
• 碰撞位掩码配置错误：两个物体的collisionBitMask都设为0，完全关闭了物理碰撞阻挡功能。
• 平面物理形状不合理：你用SCNPlane生成物理形状，这是零厚度的二维形状，小质量高速下落的物体很容易出现隧穿效应，就算掩码配对正确也可能穿透。

盒子物理体配置 #

// 必须先初始化物理体，再设置属性，之前的顺序完全颠倒
box.physicsBody = SCNPhysicsBody(type: .dynamic, shape: SCNPhysicsShape(geometry: targetGeometry, options: nil))
box.physicsBody?.isAffectedByGravity = true
box.physicsBody?.friction = 0
box.physicsBody?.restitution = 1 // 弹性系数
box.physicsBody?.angularDamping = 1 // 禁用旋转
box.physicsBody?.mass = 0.01

box.physicsBody?.categoryBitMask = foodCategory
box.physicsBody?.contactTestBitMask = heroCategory
// 配置碰撞掩码，让盒子和heroCategory类别的物体产生物理阻挡
box.physicsBody?.collisionBitMask = heroCategory
// 如果盒子下落速度快，可以开启连续碰撞检测避免隧穿
box.physicsBody?.continuousCollisionDetectionThreshold = 0.1

平面物理体配置 #

let planeGeo = SCNPlane(width: 8, height: 8)
planeGeo.firstMaterial?.diffuse.contents = UIColor.blue
planeGeo.firstMaterial?.isDoubleSided = true
let planeNode = SCNNode(geometry: planeGeo)
planeNode.simdPosition = SIMD3(x: 0, y: -4, z: -4)
planeNode.eulerAngles = SCNVector3(x: GLKMathDegreesToRadians(45), y: 0, z: 0)

// 给平面生成带微小厚度的物理形状，避免零厚度导致的隧穿
let planeCollisionShape = SCNPhysicsShape(geometry: SCNBox(width: 8, height: 8, length: 0.1, chamferRadius: 0), options: nil)
// 先初始化物理体，再设置属性
planeNode.physicsBody = SCNPhysicsBody(type: .static, shape: planeCollisionShape)
planeNode.physicsBody?.isAffectedByGravity = false
planeNode.physicsBody?.friction = 0
planeNode.physicsBody?.restitution = 0 // 弹性系数
planeNode.physicsBody?.angularDamping = 1 // 禁用旋转

planeNode.physicsBody?.categoryBitMask = heroCategory
planeNode.physicsBody?.contactTestBitMask = foodCategory
// 配置碰撞掩码，让平面和foodCategory类别的物体产生物理阻挡
planeNode.physicsBody?.collisionBitMask = foodCategory

scene.rootNode.addChildNode(planeNode)

修正后不需要在接触回调里做任何额外操作，物理引擎会自动计算碰撞，盒子落到平面上会按照你设置的弹性系数弹跳，不会穿透平面。

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