多人游戏与网络同步 / 系统课时

把客户端和服务器时间线对齐

把客户端和服务器时间线对齐

延迟补偿一旦出现“客户端说已命中、服务器日志却对不上”的问题,首先要做的不是增加日志数量,而是让两端事件能被关联、换算到同一时间轴,并保留序列号和服务器 Tick 作为因果依据。

学习目标

  • 设计能够跨客户端与服务器关联的统一事件字段
  • 用时钟偏移把两端日志投影到同一时间轴并正确排序
  • 从输入、确认、回溯与命中日志中定位异常发生在哪一段

先统一字段,再谈时间顺序

跨端日志至少要同时回答三个问题:这是哪个会话里的事件、它属于哪条输入或射击链路、它发生在本端时间线的什么位置。只记录一条 timestamp 很难回答这些问题,因为客户端与服务器的时钟原点可能不同,墙上时钟还可能被校时。

建议把字段分成四组:

字段 作用
sessionId、playerId 限定同一局与同一玩家
eventType、source 区分输入、快照、确认、回溯、命中以及事件来源
inputSeq、shotSeq、snapshotSeq、ackSeq 建立因果链并处理重复、乱序
localMonoMs、serverTick、offsetToServerMs 排序本端事件,并把客户端事件映射到服务器时间域

客户端应优先记录单调时钟值,而不是直接依赖系统日期时间。若同步阶段估计出“服务器时间减客户端时间”为 offsetToServerMs,客户端事件可用 localMonoMs + offsetToServerMs 得到仅供观测的服务器时间轴位置。

客户端与服务器事件映射到统一时间线

用一个最小脚本合并两端日志

下面的 Python 示例模拟两端各自产生日志,再把客户端事件映射到服务器时间域后排序。真实项目中可以对 JSONL、结构化日志平台或抓取后的日志文件执行同样的步骤。

python
def normalize(event):
    if event["source"] == "client":
        timeline_ms = event["localMonoMs"] + event["offsetToServerMs"]
    else:
        timeline_ms = event["serverMonoMs"]
    return timeline_ms, event

events = [
    {
        "source": "client",
        "eventType": "input_sample",
        "inputSeq": 41,
        "localMonoMs": 1000,
        "offsetToServerMs": 120,
    },
    {
        "source": "server",
        "eventType": "input_receive",
        "inputSeq": 41,
        "serverMonoMs": 1152,
    },
    {
        "source": "server",
        "eventType": "snapshot_send",
        "ackSeq": 41,
        "serverMonoMs": 1184,
    },
    {
        "source": "client",
        "eventType": "snapshot_apply",
        "ackSeq": 41,
        "localMonoMs": 1094,
        "offsetToServerMs": 120,
    },
]

for timeline_ms, event in sorted(map(normalize, events), key=lambda item: item[0]):
    seq = event.get("inputSeq", event.get("ackSeq"))
    print(f"{timeline_ms:4d} ms  {event['source']:6s}  {event['eventType']:14s}  seq={seq}")

预期输出:

text
1120 ms  client  input_sample    seq=41
1152 ms  server  input_receive   seq=41
1184 ms  server  snapshot_send   seq=41
1214 ms  client  snapshot_apply  seq=41

这组输出能直接看到:输入在统一时间轴的 1120 ms 产生,约 32 ms 后抵达服务器;服务器再过 32 ms 发出确认快照;客户端约 30 ms 后应用。实际值会随网络与调度变化,但同一条 seq=41 的链路已经可以完整追踪。

从排序结果检查因果边界

排查时不要只找“耗时最长”的一段,而要先检查事件是否满足因果约束。输入接收必须对应已发送的 inputSeq;快照里的 ackSeq 不能超过服务器实际处理过的输入;射击回溯应同时记录 shotSeq、估算的开火时间、使用的历史 Tick 与最终命中结果。

如果统一时间线显示请求很早到达服务器,但服务器 Tick 很晚才处理,问题更可能在队列或帧调度;如果服务器很快返回而客户端很晚应用,应该继续查接收线程、快照缓冲与渲染阶段。若同一个 shotSeq 出现多个最终结果,则优先检查去重与重试逻辑,而不是时钟换算。

让日志能支持一次完整复盘

上线前至少保证输入、快照、确认、回溯和命中结果都能通过会话字段与序列号串起来,并记录本端单调时间。遇到争议命中时,应能从一个 shotSeq 反查客户端开火、服务器接收、历史状态选择和最终判定,而不需要人工猜测两端时间是否对应。

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

目录与阅读设置

阅读设置

17

记录一个想法

把客户端和服务器时间线对齐

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

登录哪都通