问题场景 #

假设有两个节点Caller和Callee，Callee包含成员信号some_signal。Caller实例调用以下异步函数等待信号：

func some_func(callee):
    x = await callee.some_signal

这段代码会创建GDScriptFunctionState对象来保存协程状态，以便信号触发时恢复函数执行。核心疑问是：若Caller或Callee在协程完成前被释放，能否保证GDScriptFunctionState会被正确清理？

结论与分析 #

1. 当Caller节点被释放时 #

从Godot核心代码已合并的PR内容来看，作为协程宿主的Caller节点被释放时，对应的GDScriptFunctionState会被自动清理，不会产生内存泄漏。相关社区讨论也验证了这一行为的可靠性。

2. 当Callee节点被释放时 #

目前社区反馈显示，若仅Callee节点被释放，原有的GDScriptFunctionState可能无法被及时清理，存在潜在的内存泄漏风险。这一场景尚未在官方文档中有明确说明，需要开发者手动处理：

• 在Callee的_exit_tree或_destroyed信号中通知Caller取消协程；
• 在Caller端监听Callee的销毁信号，主动终止await等待逻辑。

注意事项 #

由于官方文档对跨节点await场景下的协程清理细节说明缺失，建议涉及此类操作时，主动添加节点销毁的监听逻辑，确保协程状态能被正确清理，避免潜在的内存问题。

内容的提问来源于stack exchange，提问作者NRagot