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

重连请求怎样避免重复加入房间

重连请求怎样避免重复加入房间

网络恢复期间,客户端可能因为超时重试,同时发送多次 Connect、JoinRoom 或 Resume。如果服务端把每次请求都当成新操作,玩家可能产生两个房间成员、重复占用座位或重复触发加入广播。本节用幂等规则把重复请求收敛到同一个会话和成员身份。

学习目标

  • 分清连接、加入房间和恢复会话三类请求应保护的资源
  • 使用请求幂等键与业务唯一键处理相同或不同重试
  • 验证重复 JoinRoom 与 Resume 不会创建第二个房间成员

幂等的目标是结果唯一而不是请求唯一

重连场景中,请求重复是正常现象。客户端发送请求后可能已经被服务端处理,只是响应在网络中丢失;客户端无法判断第一次操作是否成功,只能重试。因此服务端不能依赖“客户端绝不会重复调用”来保证状态正确。

三类操作关注的唯一对象不同。Connect 建立的是传输连接,新连接可以替换旧连接;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;恢复请求重复发送时同样不会创建成员。

python
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))

预期输出:

text
{'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 因网络问题重复多少次,同一玩家在同一房间都只对应一个有效成员身份。请求级去重负责重复消息,业务唯一约束负责并发和新请求,两层一起才能把重试安全地收敛到同一结果。

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

目录与阅读设置

阅读设置

17

记录一个想法

重连请求怎样避免重复加入房间

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

登录哪都通