游戏 AI / 系统课时
定位移动失败原因
定位移动失败原因
敌人进入追击分支却原地不动,或 Move To 刚启动就失败,并不一定是任务节点坏了。本课把问题拆成导航覆盖、角色尺寸与碰撞、目标键值、寻路配置和运行状态五层,按可复现、可观察、可排除的顺序定位根因。
学习目标
- 用导航显示与 AI 调试器确认敌人是否拿到了有效移动任务。
- 逐层检查 NavMesh 连通性、Agent 参数、碰撞与目标位置。
- 区分真正的移动失败、未结束的移动和被行为树主动中断。
固定一个最小复现场景
准备带 CharacterMovement 的敌人 Character、负责控制它的 AIController、已启动的 Behavior Tree,以及类型为 Actor 的 Blackboard 键 TargetActor。先只测试一个 Move To:让目标站在开阔地面,不要同时运行随机巡逻、攻击或频繁改写目标的 Service。
进入 PIE 后,在 Behavior Tree 资产的调试对象选择器中选中这只敌人。若根本没有进入 Move To,优先检查 AIController 是否占有 Pawn、行为树是否运行、Decorator 是否挡住分支。只有任务实际被执行,才继续查导航。
检查导航覆盖、碰撞与 Agent
在关卡视口按 P 显示 NavMesh。敌人脚下和目标附近都应有可走区域,而且两处必须属于实际可连接的导航区域;同为绿色但被墙、深沟或断层隔开的区域,不保证存在路径。检查 Nav Mesh Bounds Volume 的范围,必要时重建导航。
在运行中的游戏控制台执行:
show Navigation true预期结果:运行画面显示可通行导航面,可以直观看到敌人起点、目标落点及中途的缺口。这是视图效果,不是会打印固定文本的控制台命令。
如果只有窄门、斜坡或台阶前失败,检查角色胶囊体的半径和高度,以及导航数据的 Agent Radius、Agent Height、Agent Max Slope、Agent Max Step Height。NavMesh 允许规划的通道不一定容得下实际碰撞体;反过来,碰撞物的导航影响设置也可能把本应可走的区域挖空。先修正几何和 Agent 匹配,再考虑放宽路径限制。
核对目标数据和 Move To 选项
运行时观察 Blackboard 中的 TargetActor:它必须是有效的目标 Actor,不能已销毁、未设置或意外被 Service 清空。如果改用 Vector 键,确认值不是尚未初始化的零向量,且位置可投射到合适的导航面;楼上楼下仅有相近的平面坐标并不意味着可达。
再核对 Move To 的 Blackboard Key 是否选对。Track Moving Goal 用于跟踪会移动的目标 Actor;Observe Blackboard Value 处理黑板目标值的改变;Project Goal Location 尝试把位置投射到 NavMesh,但无法修复起点不在导航面或导航区域不连通的问题。Allow Partial Path 只允许沿不完整路径前进,不等于保证到达原目标。
用运行状态判断故障层
在 PIE 按英文单引号键 ' 打开 AI Debugger,使用数字小键盘 1 看控制器与移动状态、2 看行为树和 Blackboard、0 看导航数据;具体快捷键可参见 Unreal 官方 AI Debugging 文档。
| 观察到的现象 | 优先判断 | 下一步 |
|---|---|---|
Move To 立即 Failed |
目标无效、找不到路径或移动请求被拒绝 | 检查黑板键、起点和终点的可达性 |
持续 In Progress 却卡住 |
碰撞阻挡、动态障碍或一直达不到终点判定 | 对比导航路径、胶囊体和到达半径 |
频繁被 Aborted |
高优先级分支抢占或 Decorator 观察到键变化 | 查看是哪次状态更新触发了中断 |
很快 Succeeded 但看起来没靠近 |
已满足 Acceptable Radius 和可选的胶囊半径判定 |
核对预期停止距离,而不是当作寻路错误 |

修复后做三组回归
- 把目标放在同一块连续导航面内:敌人应能绕过静态障碍并进入预期停止距离。
- 把目标移到不可达平台:应能识别无完整路径或合理的部分路径,而不是把
Allow Partial Path误判为成功抵达。 - 在运行时移动或清空目标:确认追击更新合理,失去目标时分支有明确回退,且不会反复触发无效移动请求。
一次只改一个设置,并记录起点、目标、NavMesh 形状、Acceptable Radius 和最终任务状态。这样下一次出现相同故障,才能快速定位到真正的失败层。