游戏引擎 / 系统课时
排查客户端不同步问题
排查客户端不同步问题
客户端看到的血量、门状态或角色行为与服务器不一致时,最有效的方法不是到处加 Reliable,而是沿着 Authority、属性复制、RPC 与生命周期逐层验证。本节给出一条可复现、可记录、可在弱网下复测的排查路径。
学习目标
- 判断错误发生在服务器权威状态、属性复制还是 RPC 调用层
- 检查 Actor 复制、Ownership、Relevancy 与生命周期前提
- 使用网络模拟复现延迟和丢包下的同步异常
先确认服务器上的真值
先在至少一个服务器实例和两个客户端中复现问题,并明确“正确状态应该由谁决定”。对生命值、拾取、开门、得分等共享 Gameplay 状态,通常应由 Authority 修改,再复制到客户端。客户端本地直接改共享状态,即使画面短暂正确,也可能在后续服务器更新时被覆盖。
第一步只回答三个问题:服务器值是否正确、出错客户端是否拥有相关 Actor、另一个客户端是否也错误。若服务器本身已经错,继续查复制没有意义;若只有一个客户端错,则重点查看该连接的 Ownership、Relevancy 和生命周期。

检查属性复制链路
一个属性要从服务器稳定到达客户端,至少要满足 Actor 可复制、属性已注册、值由服务器改变,并且目标连接能够看到这个 Actor。下面给出一个最小对照实现,可放进已有 C++ 项目中,与出现故障的业务类逐项比较。
// 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();
};// 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:
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 会严格按照本地代码书写顺序在远端完成;跨对象依赖应设计明确的就绪条件,而不是依靠调用先后碰运气。
用弱网模拟验证修复
在本机低延迟环境“看起来正常”并不能证明同步模型可靠。修复后可以在测试实例控制台加入延迟和少量丢包:
NetEmulation.PktLag 150
NetEmulation.PktLoss 5预期结果:
出站数据加入约 150 ms 人工延迟,并按配置模拟约 5% 的丢包概率;实际可见效果取决于当前连接流量与可靠重传。完成测试后关闭网络模拟:
NetEmulation.Off预期结果:
网络模拟关闭,后续连接恢复为未注入人工延迟和丢包的测试状态。最终验收不应只看“RPC 打到了”。应确认服务器真值正确、所有应相关客户端最终收敛到一致状态,并且在延迟、丢包、晚加入和 Actor 重新进入相关范围时仍能恢复。这样才能证明修复的是同步模型,而不是恰好让一次本地测试通过。