游戏引擎 / 系统课时

节点计数检查切关后的残留对象

节点计数检查切关后的残留对象

关卡退出后,画面看似干净,却可能留下未释放的节点、孤立对象或重复触发的回调。本节用一个常驻审计脚本记录进出关次数、场景树节点数与孤立节点数,连续切换多轮,将稳定的大厅基线与逐轮结果比较,找出由谁创建、又该由谁清理。

学习目标

  • 建立常驻节点与临时关卡节点各自的计数基线。
  • 区分场景树内残留、树外孤立节点和重复事件回调。
  • 通过多轮切换验证销毁责任及订阅清理是否完整。

建立可比较的切关基线

创建 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 每按一次就在两张场景之间切换。

gdscript
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> 是运行时实际计数,必须以本机日志为准;按键顺序为进入、离开、再进入、再离开:

text
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=0

SceneTree.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,一次测试事件只产生约定的一次业务响应。

若数值仍上升,优先修正对象的归属与释放点,而不是手动降低计数或每次强制清空全局节点。只有计数、生命周期事件和实际交互都稳定,才能认为跨关卡复用通过验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

节点计数检查切关后的残留对象

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

登录哪都通