Photon PUN2中OnPhotonSerializeView回调无法触发的问题排查

核心原因分析 #

从你描述的现象（RPC正常但序列化回调/Transform同步失效）来看，问题大概率出在PhotonView的观察列表配置、对象所有权，或是序列化逻辑的基础设置上，以下是逐一排查的方向：

1. PhotonView的「观察列表」未添加目标组件 #

• 检查带PhotonView对象的Observed Components列表，必须把实现IPunObservable的自定义组件和PhotonTransformView都添加进去。PUN2只会同步列表内的组件，没添加的话根本不会触发序列化回调。
• 操作：选中目标对象，在Inspector面板找到PhotonView，点击+按钮将对应组件拖入列表。

2. 对象所有权异常 #

• 只有拥有对象所有权的客户端才会触发OnPhotonSerializeView的写入逻辑，其他客户端仅执行读取逻辑。如果所有客户端的photonView.IsMine都返回false，说明所有权存在问题：
  • 确认PhotonNetwork.Instantiate是在发起创建的客户端执行，且实例化时未错误设置ownershipTransfer参数。
  • 避免将网络实例化的对象误标记为「场景对象」（PhotonView的Scene View ID需为空）。

3. 自定义组件的序列化方法签名错误 #

• 确保OnPhotonSerializeView的方法签名完全正确，必须是public且无static修饰：

  public void OnPhotonSerializeView(PhotonStream stream, PhotonMessageInfo info)
  {
      if (stream.IsWriting)
      {
          // 写入需要同步的属性
          stream.SendNext(yourCustomProperty);
      }
      else
      {
          // 读取同步数据并赋值
          yourCustomProperty = (YourPropertyType)stream.ReceiveNext();
      }
  }
  

• 若读取逻辑未正确赋值，其他客户端的克隆对象属性会为空，这和你描述的现象完全匹配。

4. PhotonTransformView的配置缺失 #

• 即使挂载了PhotonTransformView，也要检查同步选项：是否勾选了Position/Rotation/Scale的同步开关，以及同步频率、插值模式是否合理。
• 同样要确保PhotonTransformView已被添加到PhotonView的观察列表中。

5. 全局网络设置验证 #

• 检查PhotonServerSettings中的AutoSyncScene是否开启，若开启但场景同步异常，可能影响对象的网络状态（不过RPC正常的话此概率较低）。
• 确认所有客户端连接的是同一房间，且PhotonNetwork.NetworkClientState为ConnectedAndReady。

快速验证步骤 #

1. 优先补全PhotonView的观察列表，添加所有需要同步的组件后运行测试。
2. 在自定义组件的Start方法中打印photonView.ObservedComponents，确认目标组件已被正确加入。
3. 测试时确保至少两个客户端连接同一房间，且创建对象的客户端photonView.IsMine返回true。

内容的提问来源于stack exchange，提问作者man3700