游戏 AI / 系统课时

路径出来却不移动怎么办

路径出来却不移动怎么办

看到 NavMesh 已经算出路径,却发现 NPC 原地不动时,不要马上怀疑寻路算法。路径查询成功、NavMeshAgent 进入可移动状态、角色 Transform 真正发生位移是三个不同阶段。本课用 Unity 的 NavMeshAgent 按这条链路逐层定位问题。

学习目标

  • 区分路径计算成功、代理可移动和角色实际位移三个阶段
  • 按固定顺序检查目标点、NavMeshAgent 状态与位置同步
  • 用运行时诊断信息判断问题究竟发生在哪一层

先把“有路径”和“会移动”分开

SetDestination 成功只表示代理接受了目标请求,并不代表角色已经开始移动。路径计算可能仍处于 pathPending,最终也可能得到部分路径;即使路径完整,isStopped、speed、位置同步等状态仍可能阻止实际位移。

可以把整个过程拆成三层:目标点首先交给路径查询;NavMeshAgent 得到路径后,根据速度、停止状态和避障结果更新内部代理位置;最后由 updatePosition 等机制把代理位置同步到角色 Transform。

路径查询、代理运动与角色位移的三阶段排查链路

用诊断脚本确定卡在哪一层

下面的脚本会先确认代理确实位于 NavMesh 上,再提交目标点,等待路径计算结束后打印关键状态。将脚本挂到带有 NavMeshAgent 的 NPC,并给 target 指定场景中的目标 Transform。

csharp
using System.Collections;
using UnityEngine;
using UnityEngine.AI;

[RequireComponent(typeof(NavMeshAgent))]
public class NavMeshMoveDiagnostics : MonoBehaviour
{
    public Transform target;

    private NavMeshAgent agent;

    private void Start()
    {
        agent = GetComponent<NavMeshAgent>();
        StartCoroutine(CheckMovement());
    }

    private IEnumerator CheckMovement()
    {
        if (target == null)
        {
            Debug.LogError("Target is not assigned.");
            yield break;
        }

        // 未放在有效 NavMesh 上时,不应继续提交路径请求。
        if (!agent.isOnNavMesh)
        {
            Debug.LogError("Agent is not on a NavMesh.");
            yield break;
        }

        bool accepted = agent.SetDestination(target.position);
        Debug.Log($"SetDestination accepted={accepted}");

        // 路径查询可能跨帧完成,等待 pathPending 结束后再判断结果。
        while (agent.pathPending)
        {
            yield return null;
        }

        Debug.Log($"pathStatus={agent.pathStatus}");
        Debug.Log($"isStopped={agent.isStopped}, speed={agent.speed:F2}");
        Debug.Log($"updatePosition={agent.updatePosition}");
        Debug.Log($"remainingDistance={agent.remainingDistance:F2}");
        Debug.Log($"velocity={agent.velocity}");
    }
}

预期输出:当路径完整、代理未暂停且位置同步开启时,会看到类似结果;距离和速度向量取决于场景实际位置。

text
SetDestination accepted=True
pathStatus=PathComplete
isStopped=False, speed=3.50
updatePosition=True
remainingDistance=<DISTANCE>
velocity=<VELOCITY>

如果 pathStatus 已经是 PathComplete,但后面的状态明显异常,就应该停止继续检查烘焙区域,转而检查移动驱动层。

按固定顺序定位最常见原因

先看 isOnNavMesh。代理如果没有正确落在 NavMesh 上,例如出生点偏离已烘焙区域,就无法作为正常导航代理工作。此时应修正出生位置,必要时使用 NavMesh.SamplePosition 在附近寻找合法落点,而不是不断重复提交目标。

接着看 pathStatus。PathPartial 表示只能到达目标方向上的某个位置,PathInvalid 表示没有有效路径。目标 Transform 在地图中存在,并不等于其位置一定处于当前代理可到达的 NavMesh 区域。

路径完整后检查 isStopped 和 speed。isStopped=true 会暂停沿当前路径移动;speed=0 则意味着代理即使拥有路径,也没有前进速度。游戏中的攻击、受击、动画或状态机经常会临时修改这些属性,因此还要检查是谁最后写入了它们。

最后检查 updatePosition。默认情况下它为 true,NavMeshAgent 会把模拟位置同步到 Transform。若项目为了 Root Motion 或自定义角色控制器主动设成 false,就必须自行使用 nextPosition 等信息完成同步,否则会出现内部代理在移动、画面中的角色却停在原地的现象。

验证修复是否真正生效

修复后不要只看 Scene 视图里的路径线。运行游戏并同时确认 pathStatus 为 PathComplete、isStopped 为 false、speed 大于零,并观察 velocity 在移动阶段不再长期保持零向量。

如果代理的速度已经非零,而角色 Transform 仍完全不变化,应优先检查 updatePosition、Root Motion、CharacterController 或项目自己的移动脚本是否覆盖了位置。反过来,如果 velocity 本身一直为零,则问题仍处于 NavMeshAgent 运动层,而不是模型或动画表现层。

排查这类问题最重要的是不要把“路径画出来了”当作移动系统已经正常。沿着路径结果、代理状态、最终位移三层逐级验证,通常能很快把问题缩小到真正负责这一层的代码。

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

目录与阅读设置

记录一个想法

路径出来却不移动怎么办

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

登录哪都通