Unity/Mirror 转移客户端权限后出现网络延迟卡顿问题排查求助

问题根因与修复方案 #

你遇到的是Unity网络组件在客户端权限切换时，NetworkTransform历史同步缓存未清空导致的队列堆积问题，结合提供的代码和现象，修复方案按优先级排列如下：

1. 修复权限移除逻辑错误 #

现有RemoveClientAuthority函数的判断条件写错，误拿NetworkTransform的连接做判断，导致权限移除失败，出现双端授权残留，旧授权端的输入缓存无法正常清空：

// 错误写法
void RemoveClientAuthority(GameObject other)
{
    if(other.GetComponent<NetworkTransform>().connectionToClient != null)
    {
        other.GetComponent<NetworkIdentity>().RemoveClientAuthority();
    }
}

// 修正写法
void RemoveClientAuthority(GameObject other)
{
    var networkIdentity = other.GetComponent<NetworkIdentity>();
    if(networkIdentity != null && networkIdentity.connectionToClient != null)
    {
        networkIdentity.RemoveClientAuthority();
    }
}

2. 权限切换时主动清空同步缓存 #

NetworkTransform内部维护了客户端同步快照队列，权限切换时如果不清空，旧授权端的历史快照会残留在队列中，新快照排队等待处理，就会出现先向旧玩家位置移动、再回溯新操作的现象，同时Client Buffer和Client Catchup占满。
在权限分配逻辑中新增清空缓存的代码：

void AssignAuthority(GameObject other)
{
    RemoveClientAuthority(other);
    var networkIdentity = other.GetComponent<NetworkIdentity>();
    networkIdentity.AssignClientAuthority(connectionToClient);
    // 新增：清空历史同步缓存，Mirror框架调用ResetSyncState，原生UNet调用ClearBuffer
    var networkTransform = other.GetComponent<NetworkTransform>();
    networkTransform.ResetSyncState(); 
}

3. 补全移动逻辑的权限判断 #

现有移动逻辑只判断了玩家自身的hasAuthority，权限切换帧存在1-2帧的同步延迟，可能出现旧授权端还在向对象写入位置的情况，需要额外判断受控对象的授权状态：

void FixedUpdate()
{
    // 补充受控对象的权限判断
    if(hasAuthority && controlledObject != null 
        && controlledObject.GetComponent<NetworkIdentity>().hasAuthority)
    {
        transform.position = controlledObject.transform.position;
        if(isHuman)
        {
            transform.rotation = controlledObject.transform.rotation;
            controllableBody.velocity = ((bodyMovement.normalized * moveSpeed) 
                + (transform.up * controllableBody.velocity.y));
            Camera.main.transform.localRotation = Quaternion.Euler(yRotation, 0f, 0f);                    
        }
    }
    // 无权限时完全由同步驱动，不要主动修改受控对象的transform、rigidbody属性
}

4. 输入逻辑权限隔离 #

现有输入逻辑无权限判断，无授权的客户端也会修改受控对象旋转，导致本地修改和同步数据冲突，需要在输入逻辑最前面加权限拦截：

void PlayerInput()
{
    // 无权限直接跳过输入处理
    if(!hasAuthority || (controlledObject != null 
        && !controlledObject.GetComponent<NetworkIdentity>().hasAuthority))
        return;
    
    float mouseX = Input.GetAxis("Mouse X") * mouseSensitivity;
    input_X = Input.GetAxisRaw("Horizontal");
    input_Z = Input.GetAxisRaw("Vertical");
    if(isHuman)
    {
        bodyMovement = (controlledObject.transform.right * input_X) 
            + (controlledObject.transform.forward * input_Z);
        controlledObject.transform.Rotate(Vector3.up * mouseX);         
    }
}

以上修改完成后，权限切换时的缓存堆积问题会完全解决，延迟不会累加，也不会再出现操作回溯的情况。

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