多人游戏与网络同步 / 系统课时
为恢复流程设计协议字段
为恢复流程设计协议字段
重连能否正确恢复,不取决于“再连一次”本身,而取决于协议是否携带足够的身份、幂等、顺序与兼容性信息。本篇把会话 ID、请求 ID、序列号、快照版本和客户端协议版本放进同一恢复握手,并给出服务端如何据此选择增量恢复、全量快照或拒绝升级的最小实现。
学习目标
- 区分会话身份、业务幂等、消息顺序、状态基线和协议兼容性各自需要的字段。
- 设计一份可判定恢复路径的重连请求,并明确字段的作用域与生命周期。
- 用可运行代码验证服务端不会把“旧会话、旧快照、旧客户端”误当成可增量恢复。
先把字段职责拆开
恢复协议最常见的问题,是让一个字段承担多个语义。例如拿 sessionId 同时表示登录身份和业务请求唯一性,或把 seq 当成状态版本。这样一旦发生重试、切服或快照重建,服务端就无法判断“这是重复请求”还是“这是同一会话里的新消息”。
核心字段建议按职责拆分:
| 字段 | 建议作用域 | 解决的问题 | 典型变化时机 |
|---|---|---|---|
sessionId |
一次逻辑在线会话 | 当前连接属于哪个会话 | 新登录或服务端明确创建新会话 |
requestId |
一次业务操作 | 重试是否为同一请求 | 每次新的购买、领取、匹配等操作 |
lastAppliedSeq |
一条服务端事件流 | 客户端已经连续应用到哪里 | 每成功应用一条有序事件后推进 |
snapshotVersion |
一份权威状态快照 | 增量日志基于哪个基线 | 服务端生成新快照时变化 |
clientProtocolVersion |
客户端构建或协议实现 | 双方字段和语义是否兼容 | 协议升级或客户端版本更新 |
requestId 不应由服务端连接号代替,因为同一个业务请求可能跨连接重试;lastAppliedSeq 也不应只记录“最后收到的包”,而要记录“已经连续应用的最大序列号”,否则中间缺包时会误报恢复进度。
让重连握手足以做一次决策
客户端重新建立传输连接后,可以先发送一条恢复握手,而不是立即重放业务操作。握手至少要让服务端回答三个问题:协议是否兼容、会话是否仍可恢复、客户端持有的快照基线是否还能用于增量追赶。

一个简化的恢复请求可以写成:
{
"sessionId": "sess-42",
"requestId": "req-reconnect-9001",
"lastAppliedSeq": 108,
"snapshotVersion": 17,
"clientProtocolVersion": 3
}这不是某个框架的固定格式,而是协议设计示例。真实项目可以使用 JSON、Protobuf 或自定义二进制协议,但字段语义应保持稳定,并在服务端集中校验。
用服务端决策代码验证边界
下面的 Python 程序模拟服务端收到恢复握手后的最小判定。规则是:协议版本不匹配时要求升级;会话不存在或快照基线失效时下发全量快照;只有会话、协议和快照都有效时才允许从 lastAppliedSeq + 1 开始补增量。
from dataclasses import dataclass
SERVER_PROTOCOL_VERSION = 3
CURRENT_SNAPSHOT_VERSION = 17
ACTIVE_SESSIONS = {"sess-42"}
LATEST_SEQ = 112
@dataclass(frozen=True)
class ReconnectHello:
session_id: str
request_id: str
last_applied_seq: int
snapshot_version: int
client_protocol_version: int
def decide_recovery(msg: ReconnectHello) -> str:
if msg.client_protocol_version != SERVER_PROTOCOL_VERSION:
return "UPGRADE_REQUIRED"
if msg.session_id not in ACTIVE_SESSIONS:
return "FULL_SNAPSHOT reason=session_expired"
if msg.snapshot_version != CURRENT_SNAPSHOT_VERSION:
return "FULL_SNAPSHOT reason=baseline_changed"
if not 0 <= msg.last_applied_seq <= LATEST_SEQ:
return "FULL_SNAPSHOT reason=invalid_sequence"
return f"RESUME_DELTA from_seq={msg.last_applied_seq + 1}"
def main() -> None:
hello = ReconnectHello(
session_id="sess-42",
request_id="req-reconnect-9001",
last_applied_seq=108,
snapshot_version=17,
client_protocol_version=3,
)
print(decide_recovery(hello))
if __name__ == "__main__":
main()预期输出:
RESUME_DELTA from_seq=109把 snapshot_version 改为 16,同一程序会返回 FULL_SNAPSHOT reason=baseline_changed;把 client_protocol_version 改为 2,则返回 UPGRADE_REQUIRED。这两个分支说明恢复协议必须能明确表达“不能增量恢复”,而不是勉强继续追日志。
约定字段的生成与保存规则
字段本身正确还不够,生成规则也必须稳定。sessionId 由服务端创建并持久到会话存储;requestId 最好由发起业务操作的一侧生成,并在重试时复用同一个值;lastAppliedSeq 只有在事件真正应用成功后才能推进;snapshotVersion 必须和快照内容一起原子发布;clientProtocolVersion 则应来自构建时常量,不能由客户端随意协商成任意值。
服务端日志也应把这些字段作为关联键输出。发生“恢复后状态少一段”时,可以先按 sessionId 找到会话,再用 snapshotVersion 确认基线,用 lastAppliedSeq 对齐缺口;发生“重复购买”时则按 requestId 查幂等记录。字段职责分离后,恢复决策和故障定位才会有可验证的证据链。