游戏 AI / 系统课时

路径有效但角色卡住了

路径有效但角色卡住了

调试时最容易误判的一种情况是:pathStatus 已经是 PathComplete,角色却站着不动、原地抖动或撞在场景边缘。本节把“路径查询成功”和“角色真正发生位移”拆开检查,用代理状态、尺寸、物理组件和移动驱动快速定位卡住的位置。

学习目标

  • 区分路径计算成功、代理产生移动速度和角色实际位移三个阶段
  • 使用运行时数据判断代理是否真的在尝试移动
  • 排查代理尺寸、物理组件和多个移动系统争抢位置的问题

先确认卡在移动链路的哪一段

NavMeshAgent 能得到完整路径,只说明起点到终点存在导航路线,并不代表角色一定可以沿路线移动。实际运行还要经过代理速度计算、局部避障以及最终的 Transform 或其他运动组件更新。

路径有效但角色卡住时的三阶段排查链路

可以先挂一个诊断脚本,把关键状态集中打印出来。下面脚本可直接挂到带有 NavMeshAgent 的角色上。

csharp
using UnityEngine;
using UnityEngine.AI;

public class NavAgentStuckDiagnostics : MonoBehaviour
{
    private NavMeshAgent agent;
    private Vector3 lastPosition;

    private void Awake()
    {
        agent = GetComponent<NavMeshAgent>();
        lastPosition = transform.position;
    }

    private void Update()
    {
        if (agent == null)
        {
            return;
        }

        float moved = Vector3.Distance(transform.position, lastPosition);
        float positionGap = Vector3.Distance(transform.position, agent.nextPosition);

        Debug.Log(
            $"[NavDiag] onMesh={agent.isOnNavMesh}, pending={agent.pathPending}, " +
            $"status={agent.pathStatus}, stopped={agent.isStopped}, " +
            $"remaining={agent.remainingDistance:F2}, desired={agent.desiredVelocity.magnitude:F2}, " +
            $"velocity={agent.velocity.magnitude:F2}, moved={moved:F3}, nextPosGap={positionGap:F3}");

        lastPosition = transform.position;
    }
}

预期输出会类似下面的格式,其中距离和速度取决于场景实际运行状态:

text
[NavDiag] onMesh=True, pending=False, status=PathComplete, stopped=False, remaining=<DISTANCE>, desired=<SPEED>, velocity=<SPEED>, moved=<DISTANCE>, nextPosGap=<DISTANCE>

如果 pathStatus=PathComplete 且 desiredVelocity 明显大于 0,说明代理已经算出了希望前进的方向;此时角色仍不移动,就应该继续检查运动执行层,而不是重新调整寻路算法。

检查代理是不是被自身设置停住

最直接的阻断项是 isStopped、speed 和代理是否仍位于 NavMesh 上。正常移动时,通常应满足 isOnNavMesh=true、isStopped=false、speed>0。如果脚本在某个状态中把 isStopped 设为 true,退出状态时却没有恢复,路径仍然可以保留,但代理不会继续前进。

还要区分 desiredVelocity 与 velocity。前者代表局部导航希望采用的速度,后者更接近代理当前实际速度。当 desiredVelocity 长期较大而 velocity 接近 0 时,常见方向是局部避障受阻、代理被其他系统限制,或角色的位置持续被外部代码覆盖。

核对代理尺寸和真实空间

导航网格上的通路是否能容纳角色,取决于烘焙时使用的 Agent Type;运行时角色又有自己的 radius、height,还可能额外挂有胶囊碰撞体或 CharacterController。几套尺寸不一致时,就容易出现“导航认为能走,实际表现却贴墙或卡在门框”的现象。

排查狭窄位置时重点比较三项:烘焙 Agent Type 的半径和高度、运行时 NavMeshAgent 的 radius 与 height、角色物理碰撞体的尺寸。不要为了让角色挤过去直接把 radius 调得远小于模型;这会让局部避障与角色视觉体积失真。正确做法是让导航尺寸代表真实移动占用空间,并重新验证窄门、拐角和低矮通道。

如果只有特定位置卡住,而开阔区域移动正常,应优先检查该位置的空间尺寸和导航边界,而不是先怀疑 SetDestination。

找出谁在修改角色位置

一个角色最好只有一个主要系统负责平移。常见冲突是 NavMeshAgent 正在更新位置,同时另一个脚本、CharacterController、非运动学 Rigidbody 或动画 Root Motion 也在修改同一个对象的位置。

当 agent.updatePosition=true 时,通常让代理负责同步 Transform;如果项目采用动画驱动移动并将 updatePosition=false,就必须由自己的运动逻辑正确消费 agent.nextPosition 或导航计算结果。两套方案混用,角色可能被一方向前推、下一帧又被另一方拉回,表现为抖动或原地踏步。

诊断日志中的 nextPosGap 很有价值:如果它持续扩大,说明代理内部位置与 Transform 已经明显分离,应搜索项目里所有对 transform.position、Rigidbody.MovePosition、CharacterController.Move 和 Root Motion 的写入,确认最终只有设计好的运动链路生效。

路径完整但角色卡住时,定位顺序应是先确认代理有没有移动意图,再检查尺寸与局部空间,最后追踪真正写入角色位置的系统。这样能把“寻路失败”和“移动执行失败”彻底分开,避免反复重烘焙一条本来就正确的路径。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

路径有效但角色卡住了

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通