多人游戏与网络同步 / 系统课时
重连请求怎样避免重复加入房间
重连请求怎样避免重复加入房间
网络恢复期间,客户端可能因为超时重试,同时发送多次 Connect、JoinRoom 或 Resume。如果服务端把每次请求都当成新操作,玩家可能产生两个房间成员、重复占用座位或重复触发加入广播。本节用幂等规则把重复请求收敛到同一个会话和成员身份。
学习目标
- 分清连接、加入房间和恢复会话三类请求应保护的资源
- 使用请求幂等键与业务唯一键处理相同或不同重试
- 验证重复
JoinRoom与Resume不会创建第二个房间成员
幂等的目标是结果唯一而不是请求唯一
重连场景中,请求重复是正常现象。客户端发送请求后可能已经被服务端处理,只是响应在网络中丢失;客户端无法判断第一次操作是否成功,只能重试。因此服务端不能依赖“客户端绝不会重复调用”来保证状态正确。
三类操作关注的唯一对象不同。Connect 建立的是传输连接,新连接可以替换旧连接;JoinRoom 创建的是房间成员关系,同一玩家在同一房间通常只能拥有一个有效成员;Resume 则应恢复已有成员,而不是再次执行加入逻辑。

两层防线处理两种重复
只缓存 requestId 还不够。第一次 JoinRoom 成功后,如果客户端进程重启并生成了新的请求 ID,再次提交同一个加入操作,简单的请求缓存无法识别它是业务重复。因此通常需要两层防线。
第一层是请求级幂等:客户端为一次逻辑操作生成 requestId,超时重试时复用该值。服务端保存已经完成的结果,再收到相同 ID 时直接返回原结果,不重复执行副作用。
第二层是业务唯一性:以 (roomId, userId) 或稳定的 membershipId 作为成员唯一键。即使新的请求使用全新的 requestId,查询或数据库唯一约束仍会找到现有成员,而不是创建第二条记录。
JoinRoom 已存在就返回原成员
普通加入流程可以遵循“先找成员,再创建”的规则。如果 (roomId, userId) 已经对应一个仍有效的成员,服务端返回原有 memberId。如果成员处于允许恢复的离线状态,应引导客户端走恢复逻辑,而不是创建新身份。
真正落到数据库时,还应为业务唯一键建立唯一约束,因为两个并发请求可能同时完成“查询不存在”。单靠应用层先查后写无法消除这个竞争窗口。
Resume 只重新绑定连接
Resume 请求至少应携带可验证的玩家身份,以及服务端签发的恢复凭据或稳定成员标识。验证通过后,服务端查找原成员,确认其仍在可恢复窗口,再把新的 transport 或 connection ID 绑定到这个成员。
恢复动作不应重新扣除入场资源、重新分配队伍槽位或再次广播“新玩家加入”。如果同一个 Resume 被重复发送,后续请求看到成员已经恢复为在线状态时,也应返回同一个成员身份,而不是报错后让客户端再次尝试 JoinRoom。
用代码验证重复请求会收敛
下面的可执行示例同时模拟请求缓存和 (room_id, user_id) 业务唯一键。即使第二次加入使用新的请求 ID,也会得到同一个 member_id;恢复请求重复发送时同样不会创建成员。
from dataclasses import dataclass
@dataclass
class Membership:
member_id: str
room_id: str
user_id: str
online: bool = True
class RoomService:
def __init__(self) -> None:
self.memberships: dict[tuple[str, str], Membership] = {}
self.request_cache: dict[str, dict[str, str]] = {}
self.next_member_number = 1
def join_room(self, request_id: str, room_id: str, user_id: str) -> dict[str, str]:
if request_id in self.request_cache:
return self.request_cache[request_id]
key = (room_id, user_id)
member = self.memberships.get(key)
if member is None:
member = Membership(
member_id=f"member-{self.next_member_number}",
room_id=room_id,
user_id=user_id,
)
self.next_member_number += 1
self.memberships[key] = member
result = {"member_id": member.member_id, "status": "joined"}
self.request_cache[request_id] = result
return result
def resume(self, request_id: str, room_id: str, user_id: str) -> dict[str, str]:
if request_id in self.request_cache:
return self.request_cache[request_id]
member = self.memberships[(room_id, user_id)]
# Resume 只恢复现有成员的在线绑定,不创建第二个成员。
member.online = True
result = {"member_id": member.member_id, "status": "resumed"}
self.request_cache[request_id] = result
return result
service = RoomService()
first = service.join_room("req-1", "room-a", "player-7")
retry_same_id = service.join_room("req-1", "room-a", "player-7")
retry_new_id = service.join_room("req-2", "room-a", "player-7")
service.memberships[("room-a", "player-7")].online = False
resume_1 = service.resume("req-3", "room-a", "player-7")
resume_2 = service.resume("req-4", "room-a", "player-7")
print(first)
print(retry_same_id)
print(retry_new_id)
print(resume_1)
print(resume_2)
print("membership_count =", len(service.memberships))预期输出:
{'member_id': 'member-1', 'status': 'joined'}
{'member_id': 'member-1', 'status': 'joined'}
{'member_id': 'member-1', 'status': 'joined'}
{'member_id': 'member-1', 'status': 'resumed'}
{'member_id': 'member-1', 'status': 'resumed'}
membership_count = 1示例中的内存字典只用于展示规则。生产服务若有多个进程或节点,请把成员唯一性放到具有原子约束的存储层,并让创建操作能够处理唯一键冲突;请求幂等结果也应放到多个实例可共享的存储中,或由固定分片保证同一玩家请求落到一致状态源。
重试时还要限制请求语义
幂等键不能被无限复用于不同操作。服务端缓存结果时应关联玩家身份、操作类型和关键参数;若相同 requestId 第一次用于加入 room-a,随后却被用于加入 room-b,应拒绝这种冲突,而不是返回与新参数无关的旧结果。
同时,Resume 必须检查成员是否仍可恢复。成员已经主动离开、保留窗口过期或恢复凭据失效时,不能因为“幂等”而重新激活旧成员。幂等保证的是重复执行得到一致结果,并不绕过身份验证、生命周期和权限检查。
可靠的重连协议最终应满足一个简单不变量:无论 Connect、JoinRoom 和 Resume 因网络问题重复多少次,同一玩家在同一房间都只对应一个有效成员身份。请求级去重负责重复消息,业务唯一约束负责并发和新请求,两层一起才能把重试安全地收敛到同一结果。