Unity Mirror点击Host报错Disconnecting connId=0空引用异常

报错定位 #

从调用堆栈可以确认，空引用异常触发在NetworkIdentity.OnStartServer()生命周期节点，也就是服务器端生成玩家对象、执行服务端初始化逻辑的阶段，Mirror核心逻辑本身没有问题，异常根源是你配置的玩家对象上存在未赋值的引用，Mirror为了防止漏洞主动断开了连接。

核心成因 #

• 玩家预制体配置缺失：你使用的Ready Player Me生成的Avatar结构和普通Unity角色不同，Animator、CharacterController等组件默认不在预制体根节点，如果直接在根节点挂脚本、按常规路径找组件，会拿到空值；另外如果脚本上暴露的引用槽（比如动画控制器、碰撞体、相机锚点）在预制体模式下未赋值，运行时生成玩家实例时就会触发空引用。
• 玩家控制器逻辑不符合Mirror网络生命周期：你参考的玩家控制器是单机逻辑编写的，大量初始化代码写在Awake/Start等通用生命周期里，没有做网络端判断。服务器端生成玩家实例时，会优先触发OnStartServer回调，这时候如果代码直接访问仅客户端存在的对象（比如主相机、本地输入系统、UI），服务器端找不到对应对象就会抛错。
• NetworkManager配置错误：如果把场景中现成的Avatar实例直接拖到NetworkManager的Player Prefab槽位，而不是用独立的预制体资源，运行时生成新玩家时会出现组件丢失、引用断裂的问题。

分步解决步骤 #

1. 修正玩家预制体配置
   • 把Ready Player Me生成的Avatar拖到Project窗口做成独立预制体，删除场景中临时放置的Avatar实例
   • 在预制体根节点挂载NetworkIdentity、NetworkTransform、玩家控制器三个组件，不要把网络组件挂在子节点上
   • 进入预制体编辑模式，逐一把玩家控制器脚本暴露的公共引用槽，从预制体自身的子节点拖对应组件赋值，特别注意：Animator组件在Ready Player Me Avatar的子节点上，不要直接拖根节点凑数。
2. 调整玩家控制器的网络生命周期逻辑
   • 把所有仅本地客户端需要执行的逻辑（比如绑定主相机跟随、初始化本地输入监听），从Awake/Start/OnStartServer中移到OnStartLocalPlayer重写方法里，确保只有本地客户端才会执行这部分代码
   • 所有获取组件、访问对象的逻辑前加判空，避免直接调用空对象的属性
     典型需要修改的代码示例：

   // 错误写法：服务器端没有主相机，运行直接空引用
   void Start()
   {
       Camera.main.GetComponent<CameraFollow>().target = transform;
   }
   
   // 正确写法：仅本地玩家执行相机绑定
   public override void OnStartLocalPlayer()
   {
       if (Camera.main != null)
       {
           Camera.main.GetComponent<CameraFollow>().target = transform;
       }
   }
   

3. 校验NetworkManager配置
   • 选中场景中挂载NetworkManager组件的对象，找到Player Prefab字段，确认赋值的是你刚做好的、根节点带NetworkIdentity的玩家预制体资源，不要赋值场景内的对象
   • 保持Auto Create Player选项为勾选状态，测试阶段不要手动在场景中提前放置玩家对象
4. 快速定位空引用源头
   • 打开本地项目中路径为Assets/Mirror/Runtime/NetworkIdentity.cs的脚本，跳转到报错提示的664行，看这行代码访问的是哪个组件/对象，这个未赋值的对象就是报错的直接原因，回到玩家预制体补全对应引用即可。

高频踩坑提示：Ready Player Me导入的Avatar默认会自动加载运行时动画控制器，如果你在玩家控制器里手动给Animator赋值控制器参数，要等Avatar加载完成后再执行，不要在初始化第一帧就直接访问Animator的参数接口，否则也会触发空引用。

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