游戏引擎 / 系统课时
节点计数检查切关后的残留对象
节点计数检查切关后的残留对象
关卡退出后,画面看似干净,却可能留下未释放的节点、孤立对象或重复触发的回调。本节用一个常驻审计脚本记录进出关次数、场景树节点数与孤立节点数,连续切换多轮,将稳定的大厅基线与逐轮结果比较,找出由谁创建、又该由谁清理。
学习目标
- 建立常驻节点与临时关卡节点各自的计数基线。
- 区分场景树内残留、树外孤立节点和重复事件回调。
- 通过多轮切换验证销毁责任及订阅清理是否完整。
建立可比较的切关基线
创建 res://home.tscn 和 res://level.tscn,根节点分别命名 Home 和 Level,类型使用 Node2D;将 home.tscn 设置为项目主场景。在 Level 根节点的「节点 → 分组」中添加持久分组 tracked_level,只给关卡根节点加这个组,避免把子节点重复计数。
在「项目 → 项目设置 → 全局/自动加载(Autoload)」中,将下列 res://scene_audit.gd 注册为 SceneAudit。它保留在两张场景之外,通过 SceneTree 的节点进出信号累计关卡根节点生命周期,并在 scene_changed 后读取稳定快照。ui_accept 每按一次就在两张场景之间切换。
extends Node
const HOME := "res://home.tscn"
const LEVEL := "res://level.tscn"
var enters := 0
var exits := 0
func _ready() -> void:
var tree := get_tree()
tree.node_added.connect(_on_node_added)
tree.node_removed.connect(_on_node_removed)
tree.scene_changed.connect(_on_scene_changed)
call_deferred("_report", "initial")
func _unhandled_input(event: InputEvent) -> void:
if not event.is_action_pressed("ui_accept"):
return
var scene := get_tree().current_scene
if scene == null:
return
var destination := LEVEL if scene.scene_file_path == HOME else HOME
var error := get_tree().change_scene_to_file(destination)
if error != OK:
push_error("切关失败,错误码:%d" % error)
func _on_node_added(node: Node) -> void:
if node.is_in_group("tracked_level"):
enters += 1
func _on_node_removed(node: Node) -> void:
if node.is_in_group("tracked_level"):
exits += 1
func _on_scene_changed(scene: Node) -> void:
# 等场景变更完成后采样,不计入交接瞬间的过渡状态
call_deferred("_report", scene.name)
func _report(stage: String) -> void:
var tree := get_tree()
var orphans := int(Performance.get_monitor(
Performance.OBJECT_ORPHAN_NODE_COUNT
))
print("%s nodes=%d orphans=%d enters=%d exits=%d live=%d" % [
stage, tree.get_node_count(), orphans,
enters, exits, tree.get_node_count_in_group("tracked_level")
])预期输出示意如下,尖括号内的 <HOME_N>、<LEVEL_N>、<BASE_O> 是运行时实际计数,必须以本机日志为准;按键顺序为进入、离开、再进入、再离开:
initial nodes=<HOME_N> orphans=<BASE_O> enters=0 exits=0 live=0
Level nodes=<LEVEL_N> orphans=<BASE_O> enters=1 exits=0 live=1
Home nodes=<HOME_N> orphans=<BASE_O> enters=1 exits=1 live=0
Level nodes=<LEVEL_N> orphans=<BASE_O> enters=2 exits=1 live=1
Home nodes=<HOME_N> orphans=<BASE_O> enters=2 exits=2 live=0SceneTree.get_node_count() 只统计树内节点,包括根窗口及 Autoload 等常驻部分;Performance.OBJECT_ORPHAN_NODE_COUNT 统计未归属于场景树的节点,需在调试运行下观察。两种计数不能相加后直接推断某一个关卡泄漏。首次采样如发生在其他初始化逻辑之前,可在一轮完整返回 Home 后重新确定基线。
区分正常常驻与异常增长
每轮应在相同条件下采样:进入 Level 后,live=1 且 enters-exits=1;回到 Home 后,live=0 且 enters=exits。回到 Home 的 nodes 应大致回到固定基线,orphans 不应随着轮次单调累积。界面缓存、全局管理器和预设对象池可能是有意常驻的,需记录其固定容量和生命周期,不应要求节点总数归零。

三种异常要分开判断:
| 观测结果 | 优先排查方向 |
|---|---|
返回 Home 后 nodes 逐轮增加 |
临时实例被挂到 Autoload 或 root,不再随关卡释放 |
orphans 逐轮增加而 Remote 树看不到新增对象 |
instantiate() 或 Node.new() 后未入树,也未调用 free() |
| 节点数稳定,但一次交互触发多次业务日志 | 重复的信号连接、多个常驻接收者或同一输入被多处处理 |
remove_child() 只把节点移出树,不负责释放;若不准备复用,应由持有它的对象调用 queue_free() 或在安全时机释放。用 queue_free() 时要等到帧末完成销毁后再对比,不应抓取删除排队中的瞬时数值。
沿创建与清理责任修复
先在 Remote 树中寻找多余实例:如果旧关卡的敌人或 UI 挂到了常驻管理器下面,追溯 add_child() 的目标,将临时节点交回关卡容器持有,或在切关时由明确的管理者统一释放。若只看到孤立数增加,则检查创建后未入树的 PackedScene.instantiate() 结果和 Node.new() 对象;取消创建分支时也必须显式 free(),不能依赖局部变量离开作用域。
对于重复回调,在事件发布点记录一次发布的调用次数,并核对接收对象是否真的只有一份。常驻信号的订阅应遵守成对连接与解除规则,使用 is_connected() 避免重复连接同一 Callable,并在不再需要时调用 disconnect()。Godot 对已释放接收对象的信号连接通常会自动断开,但这不能替代管理仍存活的订阅者或匿名回调。
用多轮回归确认稳定
保持场景和操作一致,至少进行五轮 Home → Level → Home;每次等 scene_changed 与延迟释放结束,再保存 Home 侧 nodes、orphans、enters、exits 和业务回调次数。成功条件是:返回 Home 的树内节点数回到预设基线、孤立数不持续增长、每轮 enters=exits,一次测试事件只产生约定的一次业务响应。
若数值仍上升,优先修正对象的归属与释放点,而不是手动降低计数或每次强制清空全局节点。只有计数、生命周期事件和实际交互都稳定,才能认为跨关卡复用通过验证。