Unity Netcode for GameObjects中的场景加载事件重复触发问题解析

问题现象

在使用Unity Netcode for GameObjects(简称NGO)进行网络游戏开发时，开发者可能会遇到一个特殊现象：当服务器或主机加载场景时，OnLoadEventCompleted事件会被意外触发两次。这种情况通常发生在以下场景中：

1. 纯服务器模式：首次加载场景时事件触发一次，但当有客户端连接后再次加载场景时，事件会触发两次
2. 主机模式：从开始就会在每次场景加载时触发两次事件

技术背景

OnLoadEventCompleted是NGO中SceneManager提供的一个重要事件，用于通知开发者场景加载已完成。在多人游戏开发中，正确处理场景加载事件对于同步所有客户端的游戏状态至关重要。

问题根源分析

经过技术团队深入调查，发现这类重复触发问题通常并非引擎本身的bug，而是由于事件订阅管理不当导致的。具体表现为：

1. 重复订阅：在场景重新加载时，事件订阅代码被多次执行，但没有先取消之前的订阅
2. 生命周期管理不当：网络管理器或相关组件的生命周期与场景生命周期不匹配
3. 脚本执行顺序问题：某些情况下，初始化代码可能在多个地方被调用

解决方案

1. 使用启动场景(Bootstrap Scene)模式

推荐采用启动场景模式来管理NetworkManager：

• 创建一个专门的启动场景，包含继承自NetworkManager的自定义类
• 在该场景中初始化网络管理器并保持其持久化
• 通过代码控制其他场景的加载和卸载

这种模式可以确保NetworkManager只被实例化一次，避免重复初始化导致的事件重复订阅问题。

2. 规范事件订阅流程

确保事件订阅遵循以下最佳实践：

void OnEnable()
{
    NetworkManager.Singleton.SceneManager.OnLoadEventCompleted += OnSceneLoaded;
}

void OnDisable()
{
    if(NetworkManager.Singleton != null)
    {
        NetworkManager.Singleton.SceneManager.OnLoadEventCompleted -= OnSceneLoaded;
    }
}

3. 检查脚本执行顺序

确保场景加载相关的脚本执行顺序正确：

• 避免在多个组件的Awake/Start方法中订阅同一事件
• 使用脚本执行顺序设置或初始化标志位来防止重复初始化

技术要点总结

1. 单例模式管理：NetworkManager应采用单例模式管理，确保全局唯一实例
2. 事件订阅对称：所有事件订阅都应有对应的取消订阅操作
3. 场景生命周期：理解Unity场景加载/卸载的生命周期，正确处理相关事件
4. 调试技巧：在事件处理函数中添加调试日志，帮助追踪事件触发次数和顺序

实际应用建议

在实际项目开发中，建议：

1. 建立统一的网络事件管理系统
2. 使用调试工具监控事件触发情况
3. 在场景转换时显式清理事件订阅
4. 编写单元测试验证事件触发次数

通过遵循这些最佳实践，开发者可以避免场景加载事件重复触发的问题，确保网络游戏场景切换的稳定性和可靠性。