Unity墙跑系统异常：角色进入墙跑状态后无法退出且浮空

核心问题 #

• 墙跑状态无法正常退出，即使wallRunTimer触发结束逻辑也失效
• 强制退出后角色持续浮空，重力与地面状态未正确恢复

排查修复步骤 #

1. 状态标记的重置校验 #

• 确认wallRunTimer结束后，isWallRunning这类状态标记被显式设为false，且没有其他逻辑（比如碰撞检测回调）在后续帧重新将其设为true
• 检查状态判断的分支是否覆盖所有退出场景，比如角色远离墙体时的触发逻辑

2. 刚体属性硬重置 #

退出墙跑时必须主动恢复刚体物理属性，不能依赖默认值：

// 退出墙跑的核心重置代码
rigidbody.useGravity = true;
// 清空垂直方向速度，避免残留力导致浮空
rigidbody.velocity = new Vector3(rigidbody.velocity.x, 0f, rigidbody.velocity.z);

• 这段代码必须放在状态切换的关键分支里，比如ExitWallRun()方法中

3. 地面检测逻辑补全 #

• 退出墙跑后立即触发一次地面检测（比如射线/胶囊体检测），更新isGrounded状态
• 检查地面检测的参数：射线起始点是否因墙跑时的角色偏移而偏离，检测层级是否包含地面层

4. 状态机的排他性处理 #

如果用了状态管理，确保墙跑与地面状态互斥：

• 退出墙跑时主动切换到行走/地面状态，而非仅清除墙跑标记
• 避免状态逻辑交叉，比如墙跑状态下的运动代码不要影响地面状态的执行

5. 代码执行时序调整 #

• 将状态切换逻辑放在FixedUpdate中处理，保证与物理引擎同步，避免帧延迟导致的属性重置不及时
• 检查PlayerMovement与WallRun脚本的执行顺序，确保状态重置逻辑先于运动逻辑执行

关键代码修正示例 #

WallRun脚本退出逻辑 #

private void Update()
{
    if (isWallRunning)
    {
        wallRunTimer -= Time.deltaTime;
        if (wallRunTimer <= 0f)
        {
            ExitWallRun();
        }
    }
}

private void ExitWallRun()
{
    isWallRunning = false;
    // 调用PlayerMovement的状态切换方法
    playerMovement.SwitchToGroundState();
}

PlayerMovement脚本状态处理 #

public void SwitchToGroundState()
{
    currentState = PlayerState.Ground;
    rigidbody.useGravity = true;
    // 立即执行地面检测
    CheckGround();
}

private void FixedUpdate()
{
    switch(currentState)
    {
        case PlayerState.WallRun:
            // 墙跑运动逻辑
            break;
        case PlayerState.Ground:
            // 地面运动逻辑，只有在地面状态才处理重力与行走
            if (isGrounded)
            {
                // 行走、跳跃逻辑
            }
            break;
    }
}

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