Unity Netcode for GameObjects 中 NetworkShow 调用导致重复创建对象的分析与解决

问题背景

在 Unity Netcode for GameObjects (NGO) 网络框架中，开发者可能会遇到一个特殊场景：当在 OnNetworkSpawn 生命周期方法中调用 NetworkShow 方法时，会导致客户端收到重复的 CreateObjectMessage 消息。这种情况特别容易发生在设置了 SpawnWithObservers = false 的网络对象上。

问题现象

当开发者按照以下方式实现时会出现问题：

1. 创建一个网络预制体，其组件在 OnNetworkSpawn 中调用 NetworkShow
2. 设置该预制体的 SpawnWithObservers 为 false
3. 服务器端动态生成该网络对象并指定远程客户端为所有者

此时远程客户端会收到两条 CreateObjectMessage 消息，导致以下问题：

• 控制台出现"尝试生成已存在的网络对象"警告
• 场景中出现两个相同的网络对象实例（原始对象和重复对象）

技术原理分析

这个问题的根本原因在于 NGO 内部的消息处理机制：

1. 在 NetworkObject.SpawnInternal 方法中，会先调用 NetworkManager.SpawnManager.SpawnNetworkObjectLocally
2. 该方法会触发 OnNetworkSpawn 生命周期方法
3. 如果在 OnNetworkSpawn 中调用 NetworkShow，会：
   • 将客户端ID添加到观察者列表
   • 计划在帧结束时发送 CreateObjectMessage
4. 当 SpawnNetworkObjectLocally 完成后，SpawnInternal 会遍历观察者列表并发送 CreateObjectMessage
5. 帧结束时，之前计划的 CreateObjectMessage 也会被发送

这样就导致了同一条创建消息被发送两次。

解决方案

NGO 官方提供了两种推荐的解决方案：

方案一：生成后立即显示

// 直接生成并将客户端设为所有者
var instance = NetworkManager.SpawnManager.InstantiateAndSpawn(
    m_networkPrefab, 
    clientId, 
    true);

// 生成完成后显示对象
instance.NetworkShow(clientId);

这种方案只会发送一条 CreateObjectMessage 消息，是最简洁的解决方案。

方案二：服务器生成后转移所有权

// 服务器端生成但不显示给任何客户端
var instance = Instantiate(m_networkPrefab.gameObject);
var networkObjectInstance = instance.GetComponent<NetworkObject>();
networkObjectInstance.Spawn();

// 先显示给目标客户端
networkObjectInstance.NetworkShow(clientId);

// 然后转移所有权
networkObjectInstance.ChangeOwnership(clientId);

这种方案会发送两条消息（创建消息和所有权变更消息），实现上较为复杂，通常不推荐使用。

最佳实践建议

1. 避免在生命周期方法中调用显示/隐藏方法：特别是 OnNetworkSpawn 这类早期生命周期方法

2. 使用 NGO 2.0+ 的新特性：在 NGO 2.0.0 及以上版本中，可以使用新的 NetworkPostSpawn 虚拟方法来处理这类需求，它更适合在生成完成后执行显示操作

3. 简化所有权和可见性逻辑：尽可能使用方案一的模式，保持代码简洁

4. 注意版本兼容性：该问题在 NGO 2.4.0 版本中已得到官方修复

总结

在 Unity Netcode for GameObjects 开发网络游戏时，正确处理网络对象的生成和显示顺序至关重要。理解框架内部的消息处理机制可以帮助开发者避免这类重复创建的问题。通过采用生成后显示的模式或使用新版框架的特性，可以确保网络对象在不同客户端间的正确同步。