Unity Netcode GameObjects 中主机断开连接时的 ObjectDisposedException 问题分析

问题概述

在 Unity Netcode GameObjects 项目中，当作为主机运行时，如果至少有一个客户端连接的情况下执行断开操作，系统会抛出 ObjectDisposedException 异常。这个异常会导致后续的网络功能无法正常工作。

异常表现

异常堆栈显示，问题发生在尝试访问已经被释放的 Unity.Collections.NativeList 对象时。具体来说，当 NetworkManager 尝试处理服务器关闭流程时，它需要获取连接状态信息，但此时底层的 Transport 组件已经被释放，导致无法访问必要的连接数据。

技术背景

在 Unity 网络架构中，NetworkManager 负责协调整个网络生命周期，包括连接的建立、维护和断开。而 Transport 层（如 UnityTransport）则负责实际的网络通信。这两者之间有明确的依赖关系和控制流程。

问题根源

经过分析，这个问题主要出现在以下场景：

1. 开发者手动调用了 UnityTransport 的 Shutdown 方法
2. 然后才调用 NetworkManager 的 Shutdown 方法
3. 此时 NetworkManager 尝试执行正常的断开流程（如发送断开消息给客户端）
4. 但由于 Transport 已经被关闭，导致访问已释放资源而抛出异常

正确的关闭流程

Unity Netcode 的设计预期是让 NetworkManager 统一管理 Transport 的生命周期。正确的关闭顺序应该是：

1. 调用 NetworkManager.Shutdown()
2. NetworkManager 内部会：
   • 先处理所有待发送消息
   • 向所有客户端发送断开连接通知
   • 最后关闭 Transport 组件

解决方案

对于开发者来说，应该：

1. 避免直接操作 Transport 组件的生命周期
2. 始终通过 NetworkManager 来管理网络状态
3. 如果需要切换 Transport（如从 Steam 切换到 UTP），应该在 NetworkManager 完全关闭后进行

对于框架维护者来说，可以考虑：

1. 增加 Transport 状态检查
2. 在 NetworkManager.Shutdown() 时检测 Transport 是否可用
3. 提供更友好的错误提示

最佳实践

在多 Transport 切换场景下，建议采用以下模式：

1. 完全关闭当前 NetworkManager 实例
2. 销毁当前 NetworkManager 游戏对象
3. 创建新的 NetworkManager 实例
4. 配置新的 Transport 组件
5. 启动新的网络会话

这种模式可以确保网络状态完全重置，避免残留状态导致的问题。

总结

这个问题揭示了 Unity Netcode 中组件生命周期的管理重要性。理解 NetworkManager 和 Transport 之间的控制关系对于构建稳定的网络应用至关重要。开发者应该遵循框架设计的控制流，避免绕过高层管理器直接操作底层组件。