《游戏服务端架构·核心系统与契约》前言:系统契约怎么写成可验证的东西
本篇交代卷二的技术基线、案例构造、13 章对应的 Go 验证包、L1 到 L4 的可运行性口径与数字证据规则,并给出按角色阅读、各章验证包与本地复现命令,说明怎样把系统契约写成能跑、能查、能被评审的产物,便于逐章复现与评审,并标注每条结论的证据等级。
tag
本篇交代卷二的技术基线、案例构造、13 章对应的 Go 验证包、L1 到 L4 的可运行性口径与数字证据规则,并给出按角色阅读、各章验证包与本地复现命令,说明怎样把系统契约写成能跑、能查、能被评审的产物,便于逐章复现与评审,并标注每条结论的证据等级。
为什么卷三之后还要单独写演进与治理:拆分后发布互相拖累、SLO 全绿但用户投诉、平台建好却没人用三个场景,说明机制正确不等于组织可持续。这篇序交代卷三留下的未证明项、本书的四个立场、Go 主线与 Java 21 对照的口径,以及不伪造云上实测的边界。
卷一定下了拓扑,卷二才进入真正的工期:账号归谁、结算怎么不重不漏、平台和游戏各自负责什么。这篇序说明卷二与卷一、与《MMO 服务器开发》的分工,给出贯穿三款产品的系统差异、本卷的六组系统与四个写作立场,并把每节契约落成可运行的 Go 夹具。
《游戏服务端架构》卷二全 45 篇:沿账号、登录、匹配、房间、战斗、经济、社交、榜单、邮件、支付、平台十一条系统线,把数据所有权、幂等键、失败语义与 SLA 写成可检查的契约;含序、前言、目录、附录 A–C、四条阅读路径与可运行性口径,评审时可直接对照。
《后端架构设计》卷四全 45 篇:以 Go 订单系统 arch-lab 为主线,从微服务拆分判据、契约演进、服务发现与网关,讲到配置开关、可观测性、SLO 与错误预算、混沌演练、发布工程、多租户、平台工程与成本治理,最后完成两服务拆分与带门禁发布;39 篇正文附可运行 Go 代码与测试。
一页可执行的架构评审清单:从产品事实、质量属性、拓扑与状态归属,到连接与权威、部署单元与故障域、退出条件与复审触发;给出每项的合格判据、常见不合格表现、证据要求和评审会后的闭环动作,用来替代只凭直觉和职级拍板的评审方式。
卷一的最后一节不是总结,而是交接。把基线、风险、未决决策和待压测假设做成带阻塞判定的检查清单,列出卷二必须回答的五个问题及其卷一来源,并给出可运行的 Go 交接报告生成器,说明哪些未决项可以带条件放行、哪些必须留在一卷内解决,避免把延后误写成已完成。
把卷一分散在三款产品里的决策收进一张速查表:产品事实、五特征向量、拓扑选择、状态归属、连接与权威模型、部署单元、SLA、已知风险与复审触发条件,并给出矩阵的使用方法、平局规则和失效边界,方便评审时对照自己产品的参数重新填表。
网络可靠、延迟为零、带宽无限等八个假设,在订单链路上会以重试放大、重复扣款和超时误判的形式出现。本文用可运行的 Go 重试模拟器测出三层各重试三次会把一次调用放大成 64 次,并说明为什么端到端可靠性必须由调用方与服务端的幂等共同保证,而不能交给中间链路。
同一账号在两台手机、两个客户端版本上进入不同实验分组,是实验系统最难发现的一类污染。本节定义跨端漂移、跨版本残留、互斥组重叠、长时间未刷新与重置回流等信号,给出解析当前分组、清理旧记录和重置后防回流的纯函数模型,并复盘一次双端哈希输入不一致的典型问题。
崩溃停止、崩溃恢复、消息丢失、网络分区与拜占庭故障,对调用方暴露的信号并不相同。本文用可复现的确定性网络逐项注入五类故障,配合持久化副本测试说明:订单系统默认按崩溃-恢复建模,是因为稳定存储加幂等重放能够收敛,而拜占庭需要另一套成本高得多的协议。
汇总卷一反复使用的架构术语,按品类事实、拓扑与部署、状态与时间、连接与权威、竞技/SLG/休闲、表达与治理六组编排;每个词给出本书采用的口径、容易混淆的近义词和对应章节,便于评审时统一语言、避免同一个词在不同团队里指向不同东西。
同一段订单预留逻辑,在进程内调用与跨节点调用下会暴露部分失败、响应丢失与墙上时钟错序。本文用可运行的 Go 双节点模拟器把调用结果分成 APPLIED、NOT_APPLIED、UNKNOWN 三类,并用测试说明未知状态下重试为什么必须依赖按订单号的幂等,而不是调用方的猜测。
实验开关、活动文案和入口配置都走远端下发,但拉取失败、版本回退、冷启动无配置才是客户端真正要处理的场景。本节把版本、ETag、有效期、默认值与交易字段隔离写成可测试的配置仓库,给出失败回退路径,并复盘一次旧版本覆盖新配置、导致活动入口消失的事故。
把实时性、共享世界、房间制、状态规模、跨区需求五个品类特征,与五种拓扑做成带理由和代价的决策矩阵;每个格子标注推荐、可选或不推荐,再用北辰三款产品回填验证。配套 Go 包实现特征向量打分、成本平局裁决与 25 格完整性测试,并说明矩阵在什么条件下失效。
「回声」一次直接改线上提示、没有版本记录,效果变差后无法回滚,只能凭记忆重写。本节把提示发布做成不可变版本、变更记录、确定性灰度与回滚,并要求提示与模型快照精确绑定,配可运行的 TypeScript 注册表与完整测试,并把发布审计写进事件日志。
结算页改版上线后先涨后跌,问题往往不在实验结论,而在分流与曝光口径。本节用哈希加盐实现稳定分流、用分层隔离并行实验、把渲染、可见、点击三种曝光分开,并给出只上报一次的曝光日志与灰度开关模型,代码可直接运行,最后复盘一次按会话分流的典型误判。
把卷一前十二章的决策固化成三张可评审的架构基线卡:每张写明拓扑、状态归属、连接模型、权威模型、部署单元与关键 SLA,并列出已接受的取舍、已知风险和复审触发条件。配套 Go 包用字段完整性与跨产品一致性校验,防止基线在复制粘贴和人员轮换中悄悄走样。
活动页的失败方式比商品页多得多:配置拉不到、活动未开始、已经结束、名额耗尽、运营暂停。本节把这些情况分成「配置问题」与「业务状态」,给出缓存容忍、版本回退保护、降级目标页与降级后分享参数的规则,并附一个用假时钟与可控配置源验证的 L2 模型。
「回声」摘要功能把历史、检索结果和工具输出一次性铺满窗口,提供方从尾部截断时把 system 规则一起切掉,模型开始编造。本节把上下文分成 system、历史、检索、工具四类,给出类别上限与全局裁剪顺序,并用可运行的 TypeScript 实现确定性预算规划与测试。