UE5多人游戏自定义玩家唯一ID同步异常问题求助

场景与需求 #

• 环境：UE5，使用Advanced Session插件，部署1台专用服务器+3个窗口客户端
• 操作流程：通过客户端创建会话，其余客户端查找并加入会话
• 目标：为每个玩家生成唯一的自定义ID，确保客户端与服务器端一致

已实现方案 #

1. 自定义PlayerState添加复制属性

UPROPERTY(Replicated, BlueprintReadOnly)
FString PS_UniqueStringId;

2. GameMode中实现ID生成与生命周期管理

UCLASS()
class AMY_GameMode : public AGameMode
{
    GENERATED_BODY()
public:
    UFUNCTION()
    FString GenerateUniquePlayerId();
    UFUNCTION()
    void ReleaseUniquePlayerId(const FString& IdToRelease);
    virtual void PostLogin(APlayerController* NewPlayer) override;
    virtual void Logout(AController* Exiting) override;
    virtual void EndPlay(const EEndPlayReason::Type EndPlayReason) override;
    virtual void SwapPlayerControllers(APlayerController* OldPC, APlayerController* NewPC) override;
private:
    // 原代码遗漏模板参数，需补充为TSet<FString>
    TSet<FString> UsedPlayerIds;
};

FString AMY_GameMode::GenerateUniquePlayerId()
{
    FString NewId;
    do {
        NewId = FGuid::NewGuid().ToString();
    } while (UsedPlayerIds.Contains(NewId));

    UsedPlayerIds.Add(NewId);
    return NewId;
}

3. PostLogin与SwapPlayerControllers中设置ID

void AMY_GameMode::PostLogin(APlayerController* NewPlayer)
{
    Super::PostLogin(NewPlayer);
    AMYPlayerState* PS = Cast<AMYPlayerState>(NewPlayer->GetPlayerState());
    if (PS)
    {
        PS->PS_UniqueStringId = GenerateUniquePlayerId();
        PS->ForceNetUpdate();
    }
    else
    {
        // 原代码存在空指针访问问题，此处修正为日志输出
        UE_LOG(LogTemp, Error, TEXT("PostLogin: Failed to cast to AMYPlayerState"));
    }
}

void AMY_GameMode::SwapPlayerControllers(APlayerController* OldPC, APlayerController* NewPC)
{
    Super::SwapPlayerControllers(OldPC, NewPC);
    if (OldPC && NewPC)
    {
        AMYPlayerState* OldPS = Cast<AMYPlayerState>(OldPC->GetPlayerState());
        AMYPlayerState* NewPS = Cast<AMYPlayerState>(NewPC->GetPlayerState());
        if (NewPS && OldPS && NewPS->PS_UniqueStringId.IsEmpty())
        {
            NewPS->PS_UniqueStringId = OldPS->PS_UniqueStringId;
            // 原代码遗漏ForceNetUpdate，导致客户端无法同步此ID
            NewPS->ForceNetUpdate();
        }
        else if (NewPS && NewPS->PS_UniqueStringId.IsEmpty())
        {
            NewPS->PS_UniqueStringId = GenerateUniquePlayerId();
            NewPS->ForceNetUpdate();
        }
    }
}

问题现象 #

• 服务器端GameState玩家数组中的ID均唯一且正常
• 客户端本地PlayerState的PS_UniqueStringId出现重复，甚至所有客户端ID完全相同（注：黄色ID来自本地PlayerState，蓝色ID来自GameState玩家数组）

问题原因与修复方案 #

核心原因 #

1. 复制同步不完整：部分修改ID的场景未触发服务器到客户端的同步（如SwapPlayerControllers的第一个分支未调用ForceNetUpdate()）
2. 复制机制未优化：未使用ReplicatedUsing绑定回调，无法确保客户端及时响应服务器的ID更新
3. 代码潜在错误：原代码中TSet遗漏模板参数、PostLogin分支存在空指针访问风险，可能导致逻辑异常
4. 客户端本地修改风险：若客户端代码存在直接修改PS_UniqueStringId的逻辑，会覆盖服务器同步的权威值

修复步骤 #

1. 修正容器与空指针问题

   • 确保UsedPlayerIds的类型为TSet<FString>，避免容器行为异常
   • 修复PostLogin中的空指针访问逻辑，添加错误日志而非直接访问空对象

2. 优化属性复制机制
   修改PlayerState的属性定义，使用ReplicatedUsing绑定同步回调，确保客户端收到更新时能及时处理：

   UPROPERTY(ReplicatedUsing=OnRep_UniqueId, BlueprintReadOnly)
   FString PS_UniqueStringId;
   
   UFUNCTION()
   void OnRep_UniqueId()
   {
       // 此处可添加客户端逻辑，如更新UI显示等
   }
   

3. 确保所有ID修改均触发同步
   在所有服务器端修改PS_UniqueStringId的位置，都调用ForceNetUpdate()，包括SwapPlayerControllers的第一个分支（已在代码示例中修正）

4. 限制ID修改权限
   确保只有服务器能修改PS_UniqueStringId，可通过添加服务器专用的设置函数实现：

   // 在AMYPlayerState中添加
   UFUNCTION(Server, Reliable, WithValidation)
   void Server_SetUniqueId(const FString& NewId);
   
   // 实现
   bool AMYPlayerState::Server_SetUniqueId_Validate(const FString& NewId)
   {
       return true;
   }
   
   void AMYPlayerState::Server_SetUniqueId_Implementation(const FString& NewId)
   {
       PS_UniqueStringId = NewId;
       ForceNetUpdate();
   }
   

   后续在GameMode中调用此函数替代直接赋值，避免客户端非法修改

5. 排查客户端本地逻辑
   检查客户端代码（如PlayerState的BeginPlay、构造函数或蓝图逻辑），确保没有本地修改PS_UniqueStringId的操作，避免覆盖服务器的权威值

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