《游戏服务端架构·品类、状态与拓扑》12.3 架构决策的记录、评审与复盘
一份两年前标记为 accepted 的 ADR 仍然躺在决策目录里,它依赖的 ADR 早已被取代,复审日期也过去了三个月。本节把决策当作有生命周期的图节点,讨论提议、评审、采纳、复审、失效与替代,给出取代/依赖/冲突关系的检测、复审到期提醒和失效迁移清单,并用 Go 实现决策图校验。
tag
一份两年前标记为 accepted 的 ADR 仍然躺在决策目录里,它依赖的 ADR 早已被取代,复审日期也过去了三个月。本节把决策当作有生命周期的图节点,讨论提议、评审、采纳、复审、失效与替代,给出取代/依赖/冲突关系的检测、复审到期提醒和失效迁移清单,并用 Go 实现决策图校验。
邀请关系是一本「谁欠谁奖励」的账,绑定时机早一步会被刷、晚一步会被截胡。本节比较点击、注册、首单三个绑定时机,拆开唯一性、可撤销与自己邀请自己的四类伪装,并给出一个把绑定判定、撤销与失败重试写成纯函数、可在本地用 24 条用例验证的可运行模型。
《后端架构设计·分布式与数据一致性》的阅读入口:13 章分四段的结构、章节依赖图、三条阅读路径、症状到章节的对照表、arch-lab 在卷三新增的时钟、复制、共识、分片、事务、Outbox、ID 与锁、调度和多活组件,以及实测值、目标值与示例值的口径和读完本卷的五项标准。
分享链接不是拼几个查询参数,而是一份要穿过渠道、安装包和归因窗口的承诺。本节拆开渠道码、活动 id、邀请人、商品与时间戳的生成与校验,说明分享卡片和落地页不一致时以谁为准、参数丢失后如何兜底,并给出一个可运行、可测试的 L1 分享参数与归因模型。
「回声」把运营活动文案整段塞进 system 后,智能回复开始复读活动、忽略用户问题。本节由此说明提示为什么是产物而不是字符串:模板、变量声明、版本、所有者与评审缺一不可,并用可运行的 TypeScript 实现受限模板语法、编译期变量校验与严格渲染,最后复盘一次靠记忆改提示的事故。
《裂隙战场》的一次断线重连在时序图上只有三条箭头,线上却出现房间已满、票据过期、重复重连三个异常。本节把时序图限制在跨边界交互,用状态机覆盖异常路径,用契约表固定请求、响应、错误与幂等键,并给出三者同源的 Go 校验:不可达状态、未覆盖错误和缺失幂等键都会被测试拒绝。
说明卷三怎么用:13 章四段结构、arch-lab 新增的时钟/复制/共识/分片/事务/对账组件、L1–L4 可运行性分级、代码块 file/tier/verify 标记、S1–S3 固定场景、实测与目标与示例的数字口径,以及顺序阅读和带着一次跨库改造来读的两条路线。
为什么卷二之后还要单独写分布式与数据一致性:跨库半成功、库存超卖、切换后订单倒退三个场景,暴露了单机结论的边界。这篇序交代卷二留下的六个未证明假设、本书的四个立场、Go 主线与 Java 21 对照的口径,以及不伪造多节点实测、不承诺生产级 Raft 的边界。
《后端架构设计》卷三全 45 篇:以 Go 订单系统 arch-lab 为主线,从部分失败、时钟与因果讲到复制、共识、分片、一致性模型、分布式事务、outbox、幂等对账、ID 与锁、调度和多活容灾,最后完成一次跨分片下单的一致性验证与可运行测试。
北辰工作室的架构图半年后就和仓库对不上:匹配服务拆了、存储换了、分片扩了,图还在原处。本节用上下文、容器、组件、部署四类视图加数据流视图,说明每类视图的读者与更新频率,并给出锚点校验、悬空链接检查和跨视图一致性检查的 Go 实现,让图和代码不再各说各话。
《裂隙战场》一台战斗节点故障带走 250 间房,而一个单实例会话存储故障能让全部品类同时掉线。本节把故障域分为进程、节点、机架、可用区和地域,用容量占比度量爆炸半径,给出舱壁、配额、独立连接池与去相关部署的取舍,并用 Go 实现的故障域树计算单房间、单节点与单可用区故障的影响面。
《裂隙战场》的房间服在滚动重启时丢掉进行中的对局,租约过期后新旧两个房间进程同时写结算,造成双份奖励。本节比较状态外置、分区归属、主备租约三条出路,给出房间服、地图服、会话服的边界,并用带 fencing epoch、续约、drain 与双主拒绝的 Go 租约注册表说明重启、迁移和缩容时如何不丢状态。
会员到期不是一瞬间的 UI 状态:权益会逐条失效,提醒要按节奏升级,已支付订单还要保住下单时的会员价。本节把降级拆成权益比较、提醒阶段与订单价格快照三层,说明为什么已支付订单永久锁价、待支付订单只保留到支付截止时间,并给出一个可测试的 TypeScript 模型。
积分不是端上可以随便加减的余额,而是一本由发放、抵扣、退回、过期四类流水组成的账。本节说明为什么余额必须从流水重放、过期批次为什么要先到期先出、抵扣失败为什么用退回流水而不是删除,以及多端账本如何按 id 合并,并给出一个可测试的 TypeScript 账本模型。
《群岛纪元》把登录、地图、结算和运营写进同一个二进制,一次地图热更回滚连带停掉了登录与充值。本节给出变更频率、伸缩特性、故障隔离、团队所有权和数据边界五个切分维度,比较三款产品的部署单元表,并用 Go 实现的目录模型检查循环依赖、状态归属冲突与有状态共享库。
从一次首帧后自动重试导致回复重复的事故出发,把流式错误分成首帧前与首帧后两段,给出协议内错误事件与连接断开的分工、可测试的重试决策函数,并用 node --test 验证重试上限、不可重试错误、续传位置与客户端呈现,以及首帧后失败的界面取舍。
会员页最容易把等级、有效期与权益状态混成一个字段:用户看到五条权益,实际只有两条可用。本节把会员快照、权益状态与会员价拆开,说明「可领取」为什么不等于「已拥有」、会员价为什么必须由服务端给出并在结算时重算,并给出一个可测试的 TypeScript 展示模型与到期提醒口径。
UGC 上线后,认证创作者的脚本开始调用经济接口,另一张地图试图直接发放道具。问题不在脚本写错,而在服务端把逻辑也当成了可信输入。本节给出官方、认证创作者、普通玩家三级信任模型,能力白名单、配额与审核强度,以及违规降级、升级条件和平台账本的分工与代价。
划线价、券后价与「预计省 X 元」不是三个装饰数字,而是三句可以被核验的事实陈述。本节给出划线价的展示条件、券后价与优惠金额的计算口径、不可用原因的具体文案,以及失效券保留但不给动作的展示方式,避免用不存在的原价制造假优惠。价格区因此可以按固定顺序渲染。
从用户切走私信页的瞬间出发,说明流式链路为什么需要背压、取消信号与半截响应的收敛,给出有界异步队列与流式控制器的完整 TypeScript 实现,并用 node --test 验证队列容量、背压挂起、取消时机、断流收敛、保底计量与成本漏记。