游戏引擎 / 系统课时

排查客户端不同步问题

排查客户端不同步问题

客户端看到的血量、门状态或角色行为与服务器不一致时,最有效的方法不是到处加 Reliable,而是沿着 Authority、属性复制、RPC 与生命周期逐层验证。本节给出一条可复现、可记录、可在弱网下复测的排查路径。

学习目标

  • 判断错误发生在服务器权威状态、属性复制还是 RPC 调用层
  • 检查 Actor 复制、Ownership、Relevancy 与生命周期前提
  • 使用网络模拟复现延迟和丢包下的同步异常

先确认服务器上的真值

先在至少一个服务器实例和两个客户端中复现问题,并明确“正确状态应该由谁决定”。对生命值、拾取、开门、得分等共享 Gameplay 状态,通常应由 Authority 修改,再复制到客户端。客户端本地直接改共享状态,即使画面短暂正确,也可能在后续服务器更新时被覆盖。

第一步只回答三个问题:服务器值是否正确、出错客户端是否拥有相关 Actor、另一个客户端是否也错误。若服务器本身已经错,继续查复制没有意义;若只有一个客户端错,则重点查看该连接的 Ownership、Relevancy 和生命周期。

客户端不同步的逐层排查流程

检查属性复制链路

一个属性要从服务器稳定到达客户端,至少要满足 Actor 可复制、属性已注册、值由服务器改变,并且目标连接能够看到这个 Actor。下面给出一个最小对照实现,可放进已有 C++ 项目中,与出现故障的业务类逐项比较。

cpp
// NetDiagActor.h
#pragma once

#include "CoreMinimal.h"
#include "GameFramework/Actor.h"
#include "NetDiagActor.generated.h"

UCLASS()
class ANetDiagActor : public AActor
{
    GENERATED_BODY()

public:
    ANetDiagActor();

    UFUNCTION(Server, Reliable)
    void ServerSetHealth(int32 NewHealth);

protected:
    virtual void GetLifetimeReplicatedProps(
        TArray<FLifetimeProperty>& OutLifetimeProps) const override;

    UPROPERTY(ReplicatedUsing=OnRep_Health)
    int32 Health = 100;

    UFUNCTION()
    void OnRep_Health();
};
cpp
// NetDiagActor.cpp
#include "NetDiagActor.h"
#include "Net/UnrealNetwork.h"

ANetDiagActor::ANetDiagActor()
{
    bReplicates = true;
}

void ANetDiagActor::GetLifetimeReplicatedProps(
    TArray<FLifetimeProperty>& OutLifetimeProps) const
{
    Super::GetLifetimeReplicatedProps(OutLifetimeProps);
    DOREPLIFETIME(ANetDiagActor, Health);
}

void ANetDiagActor::ServerSetHealth_Implementation(int32 NewHealth)
{
    if (!HasAuthority())
    {
        return;
    }

    Health = FMath::Clamp(NewHealth, 0, 100);
    ForceNetUpdate();
    UE_LOG(LogTemp, Log, TEXT("Server Health=%d"), Health);
}

void ANetDiagActor::OnRep_Health()
{
    UE_LOG(LogTemp, Log, TEXT("Client Health=%d"), Health);
}

这个对照类要求 Actor 由服务器存在并复制;若客户端调用 ServerSetHealth,该客户端还必须对该 Actor 具有有效 Ownership。由 owning client 触发 ServerSetHealth(70) 后,预期结果是服务器先记录权威值,相关客户端收到属性更新后执行 OnRep_Health:

text
Server Health=70
Client Health=70

客户端数量不同可能出现多条 Client Health=70。若服务器日志正确而客户端没有 OnRep_Health,继续检查 bReplicates、DOREPLIFETIME、复制条件、Relevancy、Dormancy,以及该连接是否已经拥有对应 Actor 副本。

核对 RPC 方向和 Ownership

RPC 能否到达,不只取决于 Server、Client、NetMulticast 标记,还取决于调用位置和 Ownership。常见错误是客户端在一个自己不拥有的世界 Actor 上直接调用 Server RPC,然后把“函数没有执行”误判成网络丢包。

排查时把 RPC 当成事件通道,而不是长期状态存储。需要最终一致的血量、门锁状态、任务阶段等,应由服务器修改复制属性;RPC 更适合表达一次动作或通知。Reliable 能改变可靠送达语义,但不会修复错误的 Ownership、错误的调用方向,也不会让客户端本地修改自动变成服务器真值。

如果 Server RPC 在玩家角色上能工作,搬到门或拾取物后失效,优先检查 GetOwner() 链和调用客户端是否拥有该 Actor。常见设计是让 owning PlayerController 或 Pawn 发起 Server RPC,再由服务器操作目标世界 Actor。

检查生命周期、相关性与休眠

同步问题还常发生在“时间不对”。例如客户端在 Actor 尚未获得正确 Owner 时就发送 Server RPC,或者 Actor 已进入 Dormancy 后仍期待普通属性变化立即发送。对象离开网络相关范围后,某个客户端也可能暂时收不到更新。

因此要记录关键时间点:服务器 Spawn、BeginPlay、Owner 设置、首次客户端可见、进入或退出 Dormancy、销毁。不要假设不同 Actor 的属性复制和 RPC 会严格按照本地代码书写顺序在远端完成;跨对象依赖应设计明确的就绪条件,而不是依靠调用先后碰运气。

用弱网模拟验证修复

在本机低延迟环境“看起来正常”并不能证明同步模型可靠。修复后可以在测试实例控制台加入延迟和少量丢包:

text
NetEmulation.PktLag 150
NetEmulation.PktLoss 5

预期结果:

text
出站数据加入约 150 ms 人工延迟,并按配置模拟约 5% 的丢包概率;实际可见效果取决于当前连接流量与可靠重传。

完成测试后关闭网络模拟:

text
NetEmulation.Off

预期结果:

text
网络模拟关闭,后续连接恢复为未注入人工延迟和丢包的测试状态。

最终验收不应只看“RPC 打到了”。应确认服务器真值正确、所有应相关客户端最终收敛到一致状态,并且在延迟、丢包、晚加入和 Actor 重新进入相关范围时仍能恢复。这样才能证明修复的是同步模型,而不是恰好让一次本地测试通过。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

排查客户端不同步问题

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通