游戏 AI / 系统课时
运行时地图变了怎么查
运行时地图变了怎么查
运行时加载新区域、移动障碍或替换导航数据后,常见现象是“编辑器里能走,运行一会儿突然算不到路”。这类问题通常不是单纯的寻路算法失败,而是地图变化、NavMesh 更新和代理初始化不同步。本节按时间顺序建立排查链路,把异常定位到具体阶段。
学习目标
- 能区分几何变化、障碍变化、导航数据变化和代理初始化四类问题
- 能用运行时状态确认 Agent、目标与路径是否处于有效 NavMesh 上
- 能按正确时序验证地图更新后何时才能重新提交路径
先按时间线定位变化发生在哪
运行时地图变化要先问四个问题:场景或区域什么时候完成加载,导航数据什么时候可用,角色什么时候真正落到 NavMesh 上,目标什么时候第一次提交。只看最终一次 SetDestination,很难判断前面的哪个阶段尚未准备好。
动态障碍也要单独看。如果使用 NavMeshObstacle 的 carving,障碍变化与可行走区域更新并不是“修改 Transform 后所有查询立即同步”的同一个动作;如果项目自行重建或替换导航数据,则更要避免在旧数据移除而新数据尚未可用时立即请求路径。

用探针持续记录代理与目标状态
下面脚本不会修改导航数据,只负责每隔一段时间记录代理是否位于 NavMesh、目标是否能采样到 NavMesh,以及从代理位置到采样目标能否得到路径。把它挂到出现异常的角色上,就能比较地图变化前后的状态。
using UnityEngine;
using UnityEngine.AI;
public class RuntimeNavProbe : MonoBehaviour
{
[SerializeField] private NavMeshAgent agent;
[SerializeField] private Transform target;
[SerializeField] private float sampleRadius = 1.5f;
[SerializeField] private float logInterval = 1f;
private float nextLogTime;
private readonly NavMeshPath path = new NavMeshPath();
private void Reset()
{
agent = GetComponent<NavMeshAgent>();
}
private void Update()
{
if (Time.time < nextLogTime || agent == null || target == null)
{
return;
}
nextLogTime = Time.time + logInterval;
// 目标采样失败时,先不要把问题归咎于 Agent 的移动参数。
bool targetSampled = NavMesh.SamplePosition(
target.position,
out NavMeshHit targetHit,
sampleRadius,
NavMesh.AllAreas);
NavMeshPathStatus status = NavMeshPathStatus.PathInvalid;
if (agent.isOnNavMesh && targetSampled)
{
NavMesh.CalculatePath(
agent.transform.position,
targetHit.position,
NavMesh.AllAreas,
path);
status = path.status;
}
Debug.Log(
$"time={Time.time:F1}, " +
$"isOnNavMesh={agent.isOnNavMesh}, " +
$"targetSampled={targetSampled}, " +
$"pathStatus={status}");
}
}预期结果:地图稳定时,日志应持续显示代理位于 NavMesh、目标能够采样,并得到完整或可解释的路径状态。地图切换期间如果异常,可以直接观察是哪一个字段首先变化。
time=<TIME>, isOnNavMesh=True, targetSampled=True, pathStatus=PathComplete
time=<TIME>, isOnNavMesh=False, targetSampled=True, pathStatus=PathInvalid<TIME> 是实际运行时刻。第二行表示首先失效的是代理与 NavMesh 的绑定关系,因此此时继续调整目标坐标或移动速度没有意义。
四类变化分别怎么查
场景加载后角色立即创建,但对应 NavMesh 数据稍后才可用时,agent.isOnNavMesh 可能为 false。此时不要继续调用依赖有效代理位置的移动逻辑,应先确认导航数据已经可用,再把角色放到有效网格并重新提交目标。
只有几何体发生变化,却没有同步改变导航数据时,导航查询仍可能基于旧的可行走区域。典型现象是规划路线穿过后来出现的墙体,随后角色被物理碰撞挡住。排查时要明确项目采用的是静态烘焙、NavMeshObstacle carving,还是运行时重建,三者处理地图变化的方式不同。
障碍位置频繁变化时,还要判断它是否真的需要 carving。普通移动角色或短暂经过的障碍通常更适合由局部避障处理;让大量持续移动的物体不断改变 NavMesh,反而可能造成频繁的路径失效与重新计算。
导航数据被替换之后,旧路径也不应继续被当成可信结果。地图版本发生变化时,应重新确认代理位置、目标落点和路径状态,而不是让角色继续沿一条基于旧地图计算出的路线移动。
地图更新后按固定顺序恢复
恢复时可以固定为四步:确认新导航数据已经生效,确认角色当前位置位于 NavMesh,确认目标附近存在可行走点,最后才重新计算或提交路径。只要前一步失败,就先停在这一层解决,不要继续向后调用。
如果地图替换后角色落在 NavMesh 外,可以先用 NavMesh.SamplePosition 在合理距离内寻找有效位置,再根据项目逻辑决定是否使用 NavMeshAgent.Warp 将代理重新放回网格。采样半径应与角色和关卡尺度匹配,不能通过无限扩大半径来掩盖地图断层。
按照“地图是否更新 → 代理是否仍在 NavMesh → 目标是否可落点 → 新路径是否完整”的顺序检查,可以避免在错误层反复调整速度、半径或停止状态,也更容易发现真正导致运行时寻路异常的初始化与更新时序。