游戏 AI / 系统课时
排查查询结果为空
排查查询结果为空
EQS 在编辑器里看似配置完整,运行时却可能没有候选点、所有候选被过滤,或明明选出了赢家而敌人仍不移动。本课用“查询是否执行→是否生成→是否过滤→是否可导航→是否正确消费”的顺序定位问题,避免盲目放宽全部条件。
学习目标
- 区分 EQS 未执行、候选为零、测试全失败和移动失败四类现象。
- 使用 EQS Testing Pawn 与运行时 AI Debugger 找到候选消失的环节。
- 逐一验证 Generator、Context、Test、NavMesh 和过滤阈值并恢复合理条件。
先确认故障发生在哪一层
先在 Behavior Tree 调试器中选中目标敌人,看 Run EQS Query Task 是否真正进入执行状态。如果它根本没有运行,优先检查 AIController 是否占有 Pawn、行为树是否启动、上层 Decorator 是否挡住分支。若查询成功但 Move To 失败,问题更可能在 Blackboard 键类型、导航连通性或移动代理,而不是“EQS 没有结果”。
| 可观察现象 | 优先检查 |
|---|---|
| 查询节点从不执行 | 行为树分支、Decorator、AIController |
| 没有生成任何点 | Generator 的范围、密度和生成中心 Context |
| 有点但全部判失败 | Trace、Distance、Pathfinding Test 的过滤条件 |
| 有 Winner 但无法移动 | Blackboard 写入类型、NavMesh、Move To 终点 |
用调试工具复现
在关卡中放置 EQSTestingPawn 类型的测试 Pawn,给它的 Query Template 指定出问题的 EQS。选择测试 Pawn 后观察候选球体,启用 Draw Failed Items、Draw Labels,并切换 Step to Debug Draw,对比每个 Test 前后的剩余点数及失败原因。注意测试 Pawn 的查询者与实际敌人不同:若 Generator 或 Context 依赖 Querier、AIController 或玩家目标,需要在运行时再验证一次,不能以静态预览结果替代真实执行。
在 PIE 中打开控制台,输入下面的内置调试命令:
EnableGDT预期结果:游戏视口出现 Gameplay Debugger 覆盖层(需启用相关调试功能)。选中敌人后,通过小键盘 3 切换 EQS 数据,小键盘 0 查看导航信息,小键盘 2 对照行为树;实际展示内容取决于是否运行过查询。

逐层恢复有效候选
按下面的顺序操作,每次只改一处,记录“生成数、通过数、Winner 是否存在”,否则很难判断究竟是哪项修复生效。
- Generator:暂时关闭所有 Test,只保留一个简单的 Grid 生成器。检查网格半径、间距、生成中心是否位于预期区域。连点都没有,说明问题尚未进入评分阶段。
- Context:检查生成中心和各 Test 使用的 Context。默认 Querier 对应实际查询发起者;自定义 Context 要返回有效 Actor 或位置。
TargetActor未设置时,以玩家为基准的测试可能拿不到参考目标。 - Tests:逐个恢复 Test。先改为仅评分或临时取消过滤,确认候选是否可通过;再恢复 Trace 的检测方向、碰撞通道与遮挡要求,并核对 Distance Test 是按谁到谁的距离计算。
- 导航:在编辑器按
P检查 NavMesh 可视化,确认敌人周围与预期目标区域都具有可通行网格,并检查断开的导航岛。若启用 Pathfinding Test 或投射到导航面的步骤,核对寻路起点、代理尺寸和投射范围。 - 过滤阈值:最后检查距离上下限和布尔过滤条件。Unreal 默认以厘米为距离单位;例如要求距玩家 600~900 cm,但生成器只在玩家周围 300 cm 取点,必然不可能通过距离过滤。
区分空结果和错误的赢家
“没有 Winner”通常属于生成或过滤失败;“有 Winner,但总在错误的位置”属于评分方向、权重或参考 Context 的问题。检查 Test 的 Scoring Equation、归一化与权重,确保“离目标远”或“有掩体”等偏好没有被设置成相反方向。
若 Winner 正确但 TacticalLocation 没值,检查 Run EQS Query 的 Blackboard Key 是否为 Vector,以及该查询返回的是位置而不是 Actor。如果键有效但 Move To 失败,应单独验证终点的导航可达性。查询失败时也要确认 Update BB on Fail 的清理行为,防止旧值被误当成新结果。
验证修复没有破坏战术目的
最终在无遮挡、贴墙、窄通道和目标移动四种场景复测:生成器能覆盖候选区域,关键 Test 不会把所有点意外淘汰,Winner 满足战术要求且移动可达。让敌人走完一次“发现目标→查询→写入→移动”的闭环,再恢复查询频率和严格过滤条件。
只有候选生成、过滤评分、黑板写入、导航执行都被分别确认,才能认定“空结果”问题真正解决。