Unity Netcode GameObjects 中 DontDestroyOnLoad 的使用限制与解决方案

场景持久化对象在 Netcode 中的特殊处理

在 Unity Netcode GameObjects 项目中，开发者经常需要创建跨场景持久化的管理器对象。传统 Unity 开发中，我们习惯使用 DontDestroyOnLoad 方法来实现这一需求，但在 Netcode 环境下，这种处理方式会遇到一些特殊限制。

问题现象分析

当开发者尝试对场景中的 NetworkObject 使用 DontDestroyOnLoad 方法时，会遇到以下错误提示："PlayerDataManager tried to registered with ScenePlacedObjects which already contains the same GlobalObjectIdHash value"。这表明系统检测到了重复注册的场景对象。

深入分析这个问题，其根本原因在于 Netcode 对场景中的 NetworkObject 有特殊的处理机制。当场景加载时，Netcode 会扫描并注册所有场景中的 NetworkObject。如果这些对象被标记为 DontDestroyOnLoad，在场景切换后它们不会被销毁，导致下次加载同一场景时出现重复注册的情况。

解决方案实现

针对这一问题，官方提供了几种可行的解决方案：

1. 手动销毁机制

建议在 NetworkManager 停止时主动销毁持久化对象：

public class PlayerDataManager : NetworkBehaviour
{
    private void Start()
    {
        NetworkManager.Singleton.OnClientStopped += OnNetworkStopped;
        DontDestroyOnLoad(gameObject);
    }

    private void OnNetworkStopped(bool _)
    {
        Destroy(gameObject);
    }
}

2. 单例模式改进版

更稳健的做法是结合单例模式和 DontDestroyOnLoad：

public class PlayerDataManager : NetworkBehaviour
{
    public static PlayerDataManager Instance;
    
    public bool DestroyNewInstance = true;

    private void Awake()
    {
        if (Instance != null && Instance.gameObject != gameObject)
        {
            if (!DestroyNewInstance)
            {
                Destroy(Instance.gameObject);
            }
            else
            {
                Destroy(gameObject);
                return;
            }
        }
        Instance = this;
        DontDestroyOnLoad(gameObject);
    }
}

实现注意事项

1. 静态实例引用：必须使用 static 关键字声明单例实例，确保全局可访问
2. 销毁策略选择：通过 DestroyNewInstance 参数可以灵活控制是保留旧实例还是新实例
3. 网络同步问题：确保所有网络变量在场景切换后仍然有效，避免 NativeArray 被释放的错误

最佳实践建议

对于 Netcode 项目中的持久化对象管理，推荐以下实践：

1. 对于纯粹的数据管理器，考虑使用 NetworkBehaviour 但不作为场景对象，而是动态生成
2. 如果必须作为场景对象，确保正确处理场景切换时的销毁逻辑
3. 复杂项目中可以考虑使用专门的场景管理策略，将持久化对象放在单独的场景中

通过以上方法，开发者可以在 Unity Netcode GameObjects 项目中实现稳定可靠的跨场景对象持久化，同时避免网络同步和对象管理方面的问题。