SpriteKit碰撞检测异常：右边缘与底部边缘存在无法穿越间隙

问题分析 #

你的代码在左、底部碰撞时正常，但右、顶部出现无法穿越的间隙，且碰撞检测已触发，问题出在碰撞位置计算逻辑和物理体与视觉节点的边界不匹配上：

• 直接使用node.frame计算碰撞区域，若玩家或瓦片的anchorPoint不是默认的(0.5,0.5)，或者物理体大小与节点视觉大小不一致，会导致位置计算偏差。
• 调整玩家位置时，未基于物理体的实际碰撞边界，而是用节点的视觉边界，导致间隙出现。

修复方案 #

1. 改用物理体边界替代节点Frame

将player.frame和wall.frame替换为物理体的实际碰撞边界，因为碰撞由物理体触发，物理体的边界才是真实的碰撞区域：

func handleCollision(player: SKSpriteNode, wall: SKNode) {
    guard let playerBody = player.physicsBody, let wallBody = wall.physicsBody else {
        print("Wall or player physics body is nil")
        return
    }
    
    // 获取物理体的边界（基于节点position和anchorPoint转换到场景坐标系）
    let playerBounds = playerBody.bounds.offsetBy(dx: player.position.x, dy: player.position.y)
    let wallBounds = wallBody.bounds.offsetBy(dx: wall.position.x, dy: wall.position.y)
    
    let diffX = playerBounds.midX - wallBounds.midX
    let diffY = playerBounds.midY - wallBounds.midY
    
    print("PlayerBounds: \(playerBounds), WallBounds: \(wallBounds)")
    print("diffX: \(diffX), diffY: \(diffY)")
    
    if abs(diffX) > abs(diffY) {
        // 水平碰撞
        if diffX > 0 {
            // 玩家在墙体右侧，调整位置到墙体右外侧
            player.position.x = wallBounds.maxX + playerBounds.width / 2
            print("Adjusting player to the right of the wall")
        } else {
            // 玩家在墙体左侧，调整位置到墙体左外侧
            player.position.x = wallBounds.minX - playerBounds.width / 2
            print("Adjusting player to the left of the wall")
        }
        // 只重置水平速度，保留垂直速度（避免跳跃时被打断）
        playerBody.velocity.dx = 0
    } else {
        // 垂直碰撞
        if diffY > 0 {
            // 玩家在墙体上方，调整位置到墙体上侧
            player.position.y = wallBounds.maxY + playerBounds.height / 2
            print("Adjusting player above the wall")
        } else {
            // 玩家在墙体下方，调整位置到墙体下侧（平台跳跃中这里通常是踩地面，保留水平速度）
            player.position.y = wallBounds.minY - playerBounds.height / 2
            print("Adjusting player below the wall")
        }
        // 只重置垂直速度，保留水平速度（避免走路时被打断）
        playerBody.velocity.dy = 0
    }
}

2. 检查物理体设置

• 确保玩家和瓦片的physicsBody基于节点大小创建，避免物理体与视觉节点尺寸不匹配：

  player.physicsBody = SKPhysicsBody(rectangleOf: player.size)
  wall.physicsBody = SKPhysicsBody(rectangleOf: wall.size)
  

• 确认两者的anchorPoint均为(0.5,0.5)，若自定义了锚点，需在计算边界时额外做偏移处理。

3. 优化碰撞检测触发逻辑

添加物理体类别判断，避免误触发其他无关碰撞（比如玩家和道具的碰撞）：

// 定义物理体类别枚举
enum PhysicsCategory: UInt32 {
    case player = 1 << 0
    case wall = 1 << 1
}

// 初始化物理体时设置类别与检测规则
player.physicsBody?.categoryBitMask = PhysicsCategory.player.rawValue
player.physicsBody?.contactTestBitMask = PhysicsCategory.wall.rawValue
wall.physicsBody?.categoryBitMask = PhysicsCategory.wall.rawValue

// 修改didBegin逻辑
func didBegin(_ contact: SKPhysicsContact) {
    let bodyA = contact.bodyA
    let bodyB = contact.bodyB
    
    // 判断是否为玩家与墙体的碰撞
    let isPlayerWallCollision = (bodyA.categoryBitMask == PhysicsCategory.player.rawValue && bodyB.categoryBitMask == PhysicsCategory.wall.rawValue) ||
                                (bodyA.categoryBitMask == PhysicsCategory.wall.rawValue && bodyB.categoryBitMask == PhysicsCategory.player.rawValue)
    
    guard isPlayerWallCollision else { return }
    
    // 区分玩家节点与墙体节点
    let playerNode = bodyA.categoryBitMask == PhysicsCategory.player.rawValue ? (bodyA.node as! SKSpriteNode) : (bodyB.node as! SKSpriteNode)
    let wallNode = bodyA.categoryBitMask == PhysicsCategory.wall.rawValue ? bodyA.node : bodyB.node
    
    print("Collision detected between player and wall")
    print("Player position: \(playerNode.position), Wall position: \(wallNode.position!)")
    handleCollision(player: playerNode, wall: wallNode!)
}

关键说明 #

• 物理体的bounds是以节点锚点为原点的矩形，必须用offsetBy转换到场景坐标系，这是之前用frame出错的核心原因。
• 分开重置水平/垂直速度，避免破坏玩家的移动体验（比如跳跃时保留水平移动，走路时保留跳跃能力）。

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