《游戏服务端架构·核心系统与契约》6.1 货币、产出与消耗
《群岛纪元》一次活动配置把奖励放大十倍,团队却只能看到余额异常,查不出是哪条产出路径、发给了谁、是否已流入玩家交易。本节结合三款产品的货币分层,比较单表余额、双分录账本与事件溯源,说明来源标签、对账频率和差异处置,并给出可运行的 Go 双分录账本与失败模式。
category
《群岛纪元》一次活动配置把奖励放大十倍,团队却只能看到余额异常,查不出是哪条产出路径、发给了谁、是否已流入玩家交易。本节结合三款产品的货币分层,比较单表余额、双分录账本与事件溯源,说明来源标签、对账频率和差异处置,并给出可运行的 Go 双分录账本与失败模式。
从「回声」发帖按钮转圈八秒的事故写起,说明同步与异步的分界线不是操作快慢,而是用户此刻是否在等结果、失败后能否撤回。文章把发帖拆成写库、图片处理、审核与通知四段,给出可测试的 Decide 与 Explain 实现和边界测试,避免把后台副作用塞进用户请求。
从大 V 发帖打满单个分片、整点配置统一过期两次事故写起,说明热 key 与集中失效是两种不同故障,给出访问占比探测、样本门槛与稳定分片的可测试 Go 实现,并讨论大 V 发帖、秒杀与整点刷新三类热点的观测和处置顺序,避免用同一套手段处理两种不同事故。
从头像改完八分钟仍显示旧图的事故写起,说明缓存位置决定一致性窗口,而不是加了缓存就快;拆解本地缓存、Redis 与 CDN 的 TTL 如何叠加,并给出窗口求和与产品预算判断的可测试 Go 实现,以及版本化 URL 和分层失效的处理方式,减少重复上传。
从一个社区首页按 DAU 估算缓存容量、结果命中率只有 22% 的事故写起,说明读多写少不是拍脑袋的常识,而是要用读次数、写次数、独立键数与值大小测出来的事实,并给出读写比、工作集和缓存建议的可测试 Go 实现,避免继续用请求量代替缓存容量。
从「回声」热点文章缓存 TTL 同时到期、98% 命中率仍把源站打挂的事故写起,说明边缘缓存必须配合合并回源、并发上限和等待预算三条保护机制,并给出 singleflight 语义的 Guard 实现与并发测试,解释为什么缓存越生效越危险。
从「回声」网关用字符串前缀匹配,把 /api/user-admin 导流到用户服务、普通会话触发管理导出的事故写起,说明网关只该做连接终结、认证、路由和限流四件事,并给出 Host 优先级、路径段边界匹配与认证检查的 Go 实现和表驱动测试。
从「回声」把个性化推荐错误地放进 CDN、A 用户看到 B 用户推荐的事故写起,说明静态与动态的分界依据是同一份内容对多少人相同,而不是文件后缀;再给出路径分类与缓存策略的 Go 实现和边界测试,并解释为什么 API 前缀必须优先于扩展名判断。
从服务端删掉一个字段导致三个月未升级的 App 白屏的事故写起,说明兼容窗口为什么由客户端版本分布决定而不是服务端想象,梳理新增、改名、删除、收紧校验和主版本升级的处理方式;并附版本解析、兼容判断与退役时间检查的 Go 实现、表驱动测试和真实运行输出。
从大促零点一条把 SQL 报错返回给用户的事故写起,说明错误码为什么是产品契约而不是异常栈导出,如何区分用户可解决、系统可恢复与不该发生的失败,并用可重试标记约束客户端的自动重试行为;附错误码表校验与查询的 Go 实现和边界测试,避免局部故障被重试放大成全站事故。
从「回声」点赞按钮被预取和重试重复执行的事故写起,说明资源查询与命令的本质区别、命令自然键的组成,以及同一动作在 App、Web、小程序三端为什么必须共用一套语义;附 HTTP 方法分类器的 Go 实现与表驱动测试,把幂等和可缓存钉在接口入口。
从「回声」为省一次请求把 2MB 数据塞进首屏接口的事故写起,拆解首屏时间、流量、电量和弱网四个端上约束,说明服务端能做什么、不该做什么,并用一个按优先级裁剪的 Go 预算函数把取舍变成可执行代码,避免首屏被一个大响应拖垮并显著放大故障半径。
从「回声」首页一个下游超时导致整页空白的事故写起,说明 BFF 聚合为什么不是把接口拼成一个 JSON,并把字段来源、失败语义、缓存键和按端裁剪写成一份可测试的契约,附聚合与合并的 Go 实现和边界测试,避免把五个下游的故障绑成一个更大的故障。
从「回声」小程序复用 App 未读模型的事故写起,把 iOS、Android、Web 与小程序的登录态、推送、深链、包体上限差异整理成一张能力表,并用一段可测试的 Go 代码说明 BFF 为什么必须按端裁剪,以及未知端为什么不能默认兜底,避免同一个接口把强端和弱端一起拖死。
从「回声」用户注销后仍能在备份里找回账号的事故说起,说明 pending、deleted、purged 三态注销机如何约束导出、删除、备份清除和审计留痕的时序,给出拒绝提前清除、校验备份窗口的 Go 实现与状态测试,并讨论日志、备份和审计记录里残留个人信息该怎么收尾。
从「回声」注册页多收的一个手机号说起,说明公开、内部、敏感三级字段如何按注册、推荐、客服、风控四个目的裁剪,给出保持输入顺序、拒绝负数保留期的 Go 最小化函数与测试,并拆解全量采集在注销、日志、第三方 SDK 和备份上留下的实际代价与审计缺口。
以「回声」个人主页上线三天后的一次手机号字段泄露为入口,拆解公开、好友、自己三档可见性,讨论好友的好友、拉黑之后能否看到历史内容、本人可见与未知档位的边界,给出可测试的 Go 过滤器和表驱动测试,并说明为什么前端隐藏字段不能替代服务端过滤,最后列出落地时的常见错误与审计要求。
从一次撞库事件讲起,说明账号维度、IP 维度和设备维度为什么要分别计数,给出滑动窗口、成功清零和可读拒绝原因的 Go 限流实现,并用测试覆盖同账号多 IP、同 IP 多账号、窗口过期与成功清零,最后附上本机运行输出和常见错误清单,让防爆破与防撞库不再互相替代。
从「旧手机还能继续用」的线上问题讲起,说明会话不是 token,拆解设备上限、登录时间、踢出原因与多端互踢的产品语义,再用可测试的 Go 会话存储实现设备复用、最旧设备淘汰和不可恢复的撤销,并附上本机测试输出与常见错误清单,帮助团队把踢出动作落成服务端状态,而不是只在前端删掉一个字符串。
从一个账号绑定手机号、微信和 Apple 的冲突讲起,区分账号与身份,给出合并策略、冲突判定和可回归的 Go 绑定实现,并用测试锁定重复回调、幂等绑定与跨账号抢占三种边界,最后附上本机运行输出与常见错误清单,帮助团队在接入第三方登录前把规则写进代码。