【Unity陷阱】OnDestroy中生成GameObject：为何会触发‘Some objects were not cleaned up’？

1. 为什么在OnDestroy中生成GameObject会报错？

当你在Unity编辑器中停止运行游戏或切换场景时，可能会遇到这样的报错信息："Some objects were not cleaned up when closing the scene. (Did you spawn new GameObjects from OnDestroy?)"。这个错误看起来有点莫名其妙，特别是当你确信自己已经做了"正确"的清理工作时。

实际上，这个问题的根源在于Unity的生命周期管理机制。当游戏停止运行时，Unity会按照特定顺序调用所有活动GameObject的OnDestroy方法。这个阶段本应是用来释放资源和清理对象的，但如果你在这里创建新的GameObject，就会打乱Unity的清理流程。

想象一下，你正在收拾房间准备搬家（相当于Unity在清理场景）。当你把所有家具都打包好准备运走时，突然又往房间里搬进一个新沙发（相当于在OnDestroy中创建新GameObject）。这不仅打乱了你的搬家计划，还会让搬运工（Unity引擎）感到困惑——"不是说好要清空房间的吗？怎么又多出东西来了？"

2. Unity的生命周期与OnDestroy的执行机制

2.1 Unity的生命周期概述

Unity的MonoBehaviour脚本有一系列明确的生命周期方法，从Awake到OnDestroy，每个方法都有其特定的调用时机和用途。理解这些方法的执行顺序对于避免这类问题至关重要。

在游戏运行结束时，Unity会按照以下顺序执行清理工作：

1. 首先调用所有活动GameObject的OnDisable方法
2. 然后调用OnDestroy方法
3. 最后Unity才会进行内部资源清理

2.2 OnDestroy的特殊性

OnDestroy方法有几个关键特性需要注意：

• 调用顺序不确定：Unity不保证不同GameObject上OnDestroy方法的调用顺序
• 执行环境特殊：此时Unity已经进入"清理模式"，很多系统功能可能已经不可用
• 对象状态不稳定：其他对象可能已经被销毁，引用可能已经失效

这就解释了为什么在OnDestroy中创建新对象会导致问题。你无法预测此时系统中哪些部分还"活着"，哪些已经被清理掉了。

3. 单例模式在OnDestroy中的陷阱

3.1 单例的生命周期问题

很多开发者喜欢使用MonoBehaviour单例来管理游戏状态，这在大多数情况下工作良好。但在OnDestroy中访问这些单例就可能出问题，特别是当单例本身也被销毁时。

考虑这个场景：

public class GameManager : MonoBehaviour { public static GameManager Instance; void Awake() { Instance = this; } void OnDestroy() { // 单例引用置空 Instance = null; } } public class Player : MonoBehaviour { void OnDestroy() { // 这里可能出问题 GameManager.Instance.SaveData(); } }

问题在于，你不知道GameManager和Player哪个会先被销毁。如果GameManager先被销毁，那么Player.OnDestroy中访问Instance就会触发单例的重新创建。

3.2 改进的单例实现

为了防止这种情况，我们可以改进单例的实现方式：

public class SafeSingleton<T> : MonoBehaviour where T : MonoBehaviour { private static T _instance; private static bool _isQuitting = false; public static T Instance { get { if (_isQuitting) { Debug.LogWarning($"Singleton {typeof(T)} instance already destroyed."); return null; } if (_instance == null) { _instance = FindObjectOfType<T>(); if (_instance == null) { GameObject obj = new GameObject(typeof(T).Name); _instance = obj.AddComponent<T>(); DontDestroyOnLoad(obj); } } return _instance; } } protected virtual void OnDestroy() { if (_instance == this) { _isQuitting = true; _instance = null; } } }

这个实现添加了_isQuitting标志位，在应用退出时阻止新实例的创建。

4. 正确的资源清理模式

4.1 应该在何时进行清理

与其在OnDestroy中进行复杂的清理操作，不如考虑以下替代方案：

1. 场景卸载前：使用SceneManager.sceneUnloaded事件
2. 游戏暂停时：OnApplicationPause
3. 定期保存：定时或关键节点自动保存

4.2 安全的清理代码示例

这是一个更安全的资源清理模式：

public class SafeCleanup : MonoBehaviour { private bool _isQuitting = false; void OnApplicationQuit() { _isQuitting = true; } void OnDestroy() { if (_isQuitting) { // 应用退出时，只做最简单的清理 ReleaseNativeResources(); } else { // 正常场景切换时，可以执行完整清理 FullCleanup(); } } void ReleaseNativeResources() { // 释放非托管资源 } void FullCleanup() { // 完整的清理逻辑 SaveData(); UnregisterEvents(); ReleaseResources(); } }

5. 实际项目中的最佳实践

5.1 避免在OnDestroy中做的操作

根据经验，以下操作应该避免在OnDestroy中进行：

• 创建新的GameObject或组件
• 加载资源或场景
• 调用可能依赖其他对象的复杂逻辑
• 执行耗时操作（网络请求、文件IO等）

5.2 推荐的替代方案

对于常见的需求，可以考虑这些替代方案：

1. 数据保存：

   • 使用PlayerPrefs在数据变更时实时保存
   • 实现定期自动保存机制
   • 在场景切换前保存（使用SceneManager.activeSceneChanged）

2. 资源释放：

   • 实现手动释放接口，在不再需要时立即释放
   • 使用using语句管理临时资源
   • 实现引用计数机制

3. 事件解注册：

   • 使用WeakReference避免强引用
   • 在OnDisable中解注册而不是OnDestroy
   • 实现自动清理的事件系统

5.3 调试技巧

当遇到"Some objects were not cleaned up"错误时，可以尝试以下调试方法：

1. 在Edit > Project Settings > Editor中开启"Enter Play Mode Options"下的"Domain Reload"和"Scene Reload"，这可以帮助快速重现问题。

2. 使用Unity的Deep Profiling工具分析销毁阶段的性能和行为。

3. 在脚本中添加日志，跟踪OnDestroy的调用顺序：

void OnDestroy() { Debug.Log($"{gameObject.name} OnDestroy called", this); }

4. 检查场景中所有实现了OnDestroy的脚本，特别关注那些可能创建新对象的代码。

6. 高级话题：Unity的清理流程深入

6.1 编辑器模式与发布模式的差异

值得注意的是，这个错误在编辑器模式下更常见，而在发布版本中可能不会出现。这是因为编辑器有额外的检查逻辑来确保资源被正确清理。

在编辑器停止运行时，Unity会：

1. 标记所有对象为待销毁
2. 调用OnDestroy
3. 检查是否有新对象被创建
4. 如果有，则报错并保留这些对象（防止内存泄漏）

而在发布版本中，Unity会更直接地清理所有资源，可能不会进行这么严格的检查。

6.2 非托管资源的特殊处理

对于非托管资源（如文件句柄、网络连接等），即使不在OnDestroy中创建新对象，也需要特别注意：

public class ResourceHolder : MonoBehaviour { private FileStream _fileStream; void OnDestroy() { // 必须确保非托管资源被释放 _fileStream?.Dispose(); } }

对于这类资源，最好实现IDisposable接口，并使用using语句管理生命周期。

7. 其他常见相关错误

除了"Some objects were not cleaned up"错误外，在OnDestroy中不当操作还可能导致：

1. "MissingReferenceException" - 尝试访问已销毁的对象
2. "InvalidOperationException" - 在非法状态下调用Unity API
3. 内存泄漏 - 未正确释放资源
4. 数据丢失 - 保存操作未能完成

理解这些错误的内在联系，可以帮助你更快地定位和解决问题。