游戏 AI / 系统课时

用日志还原一次执行路径

用日志还原一次执行路径

行为树出现“NPC 明明有目标却去巡逻”时,只看最终状态很难定位问题。本节把节点进入、状态结果和退出统一记录成结构化日志,再用 tickId 与节点路径还原一次真实执行链。

学习目标

  • 确定行为树调试日志中真正有用的字段。
  • 为节点统一记录 ENTER、STATUS、EXIT 三类事件。
  • 能按一次 tick 的日志顺序反推出实际执行路径和失败位置。

一条日志要回答哪些问题

调试日志的目标不是“多打印几行”,而是回答四件事:这是哪一次树更新、执行了哪个节点、节点发生了什么事件、结果是什么。最小字段可以保留 seq、tickId、nodePath、event 和 status。

nodePath 比单独的节点名更重要。树里可能有多个 HasTarget,如果只打印节点名,就无法知道它属于战斗分支还是逃跑分支。路径应稳定,例如 /Root/Combat/HasTarget,这样日志才能直接映射回树结构。

行为树节点事件写入日志并反向还原执行路径

给所有节点套同一层追踪

最稳妥的做法是把日志放在统一包装层,而不是让每个业务节点自己拼字符串。下面的 Node.js 示例为叶子节点和 Selector 记录同一种事件格式,因此可以直接按顺序还原路径。

js
const Status = {
  SUCCESS: "SUCCESS",
  FAILURE: "FAILURE"
};

function createTracer(tickId) {
  let seq = 0;

  return {
    emit(nodePath, event, status = "-") {
      seq += 1;
      console.log(JSON.stringify({
        seq,
        tickId,
        nodePath,
        event,
        status
      }));
    }
  };
}

function leaf(nodePath, result) {
  return {
    tick(tracer) {
      tracer.emit(nodePath, "ENTER");
      tracer.emit(nodePath, "STATUS", result);
      tracer.emit(nodePath, "EXIT", result);
      return result;
    }
  };
}

function selector(nodePath, children) {
  return {
    tick(tracer) {
      tracer.emit(nodePath, "ENTER");

      for (const child of children) {
        const result = child.tick(tracer);
        // Selector 只在 FAILURE 时继续尝试下一个子节点。
        if (result !== Status.FAILURE) {
          tracer.emit(nodePath, "STATUS", result);
          tracer.emit(nodePath, "EXIT", result);
          return result;
        }
      }

      tracer.emit(nodePath, "STATUS", Status.FAILURE);
      tracer.emit(nodePath, "EXIT", Status.FAILURE);
      return Status.FAILURE;
    }
  };
}

const root = selector("/Root", [
  leaf("/Root/Combat", Status.FAILURE),
  leaf("/Root/Patrol", Status.SUCCESS)
]);

root.tick(createTracer("tick-42"));

预期输出:

text
{"seq":1,"tickId":"tick-42","nodePath":"/Root","event":"ENTER","status":"-"}
{"seq":2,"tickId":"tick-42","nodePath":"/Root/Combat","event":"ENTER","status":"-"}
{"seq":3,"tickId":"tick-42","nodePath":"/Root/Combat","event":"STATUS","status":"FAILURE"}
{"seq":4,"tickId":"tick-42","nodePath":"/Root/Combat","event":"EXIT","status":"FAILURE"}
{"seq":5,"tickId":"tick-42","nodePath":"/Root/Patrol","event":"ENTER","status":"-"}
{"seq":6,"tickId":"tick-42","nodePath":"/Root/Patrol","event":"STATUS","status":"SUCCESS"}
{"seq":7,"tickId":"tick-42","nodePath":"/Root/Patrol","event":"EXIT","status":"SUCCESS"}
{"seq":8,"tickId":"tick-42","nodePath":"/Root","event":"STATUS","status":"SUCCESS"}
{"seq":9,"tickId":"tick-42","nodePath":"/Root","event":"EXIT","status":"SUCCESS"}

日志已经证明真实路径是 /Root 进入后先执行 /Root/Combat,战斗分支失败,随后才执行 /Root/Patrol,最终根节点成功。这个结论不依赖屏幕上看到的动画结果,因此特别适合定位“表现看起来正常,但决策路径不对”的问题。

从日志反查失败位置

排查时先按 tickId 过滤出一次完整更新,再按 seq 升序阅读。看到某个节点的 STATUS=FAILURE 后,不要立即认定它就是根因,还要继续向后看父节点如何处理这个失败,以及是否进入了预期备用分支。

如果日志中出现 ENTER 却没有对应的 STATUS 或 EXIT,优先检查异常、提前返回或异步节点是否破坏了生命周期。若同一个 nodePath 在一次 tick 中异常重复进入,则应检查父节点是否重复调用,或树结构是否意外共享了同一节点实例。

控制日志量而不是关闭日志

行为树每帧都可能 tick,生产环境若记录所有事件,很快会产生大量重复日志。常见做法是在调试级别记录完整 ENTER/STATUS/EXIT,而线上只保留状态变化、失败、超时和异常分支,并给一次执行链保留稳定的 tickId 或 traceId。

真正有价值的行为树日志应该能回答“这一次为什么走到这里”。只要节点路径稳定、事件格式统一、顺序字段可靠,就可以从结果反查路径,而不必靠猜测 NPC 当时做了什么。

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

目录与阅读设置

阅读设置

17

记录一个想法

用日志还原一次执行路径

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

登录哪都通