Unity中3D角色跳跃动画异常问题排查与解决咨询

1. FixedUpdate动画逻辑意外覆盖跳跃动画 #

跳跃触发后，物理帧（FixedUpdate）可能先于动画帧执行，此时角色尚未完全离开地面，IsGround()仍返回true。若此时有移动输入，FixedUpdate会触发SwitchAnimation("Run")，直接将CanJump设为false，导致跳跃动画被中断；即使无移动输入，若浮点精度问题导致_rigidBody.velocity.y > 0判断失效，也会触发Idle动画覆盖跳跃状态。

修复代码：
在ScriptPlayerMove的FixedUpdate中，增加跳跃状态判断，仅当未处于跳跃状态时才切换Idle/Run：

// 需要在ScriptPlayerMove中添加Animator引用，或者在PlayerAnimationController中加判断方法
private Animator _animator;

private void Awake()
{
    // 原Awake代码...
    _animator = GetComponent<Animator>();
}

// 修改FixedUpdate中的动画切换逻辑
if (_playerCheckGround.IsGround())
{
    // 若当前处于跳跃状态，不切换动画
    if (_animator.GetBool("CanJump")) return;
    if (_rigidBody.velocity.y > 0) return;
    _playerAnimatorController.SwitchAnimation("Run");
}
// else分支同理添加判断
else
{
    if (_playerCheckGround.IsGround())
    {
        if (_animator.GetBool("CanJump")) return;
        if (_rigidBody.velocity.y > 0) return;
        _playerAnimatorController.SwitchAnimation("Idle");
    }
}

2. 跳跃动画误用Bool参数 #

跳跃是一次性触发动作，用Bool参数需手动管理状态重置，极易出现状态不一致（比如动画播放完未重置Bool，落地后无法切换回Idle/Run；或跳跃过程中被其他逻辑覆盖）。

修复代码：

1. 将Animator中的CanJump参数从Bool改为Trigger。
2. 修改PlayerAnimationController的SwitchAnimation方法：

case "Jump":
{
    _animator.SetBool("CanIdle", false);
    _animator.SetBool("CanRun", false);
    _animator.SetTrigger("CanJump"); // 改为Trigger，自动消耗状态
    break;
}

3. 地面检测精度不足 #

单射线检测容易漏检（比如角色站在平台边缘、凹凸地面），导致IsGround()返回错误值，间接引发动画状态异常。

修复代码：
改用胶囊体检测替代单射线，贴合角色碰撞范围：

// 修改PlayerCheckGround的IsGround方法
public bool IsGround()
{
    Vector3 capsuleBottom = transform.position - new Vector3(0, _capsuleCollider.height / 2f, 0);
    Vector3 capsuleTop = capsuleBottom + new Vector3(0, _capsuleCollider.radius * 2, 0);
    // 排除自身层，避免检测到自己的碰撞体
    bool hitSomething = Physics.CheckCapsule(capsuleTop, capsuleBottom, _capsuleCollider.radius, ~LayerMask.GetMask("Player"));
    PlayerStayOnGround = hitSomething;
    Debug.DrawLine(capsuleTop, capsuleBottom, hitSomething ? Color.green : Color.red);
    return PlayerStayOnGround;
}

4. Velocity赋值方式引发物理状态突变 #

直接覆盖_rigidBody.velocity的x/z分量，会干扰物理引擎计算，可能导致跳跃过程中velocity.y异常，间接影响动画判断。

修复代码：
改用平滑过渡的方式设置velocity：

// 替换FixedUpdate中的velocity赋值代码
Vector3 targetVelocity = new Vector3(movement.x * _speedMove, _rigidBody.velocity.y, movement.z * _speedMove);
_rigidBody.velocity = Vector3.Lerp(_rigidBody.velocity, targetVelocity, Time.fixedDeltaTime * 5f);

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