《互联网产品的客户端架构·规模化与架构演进》附录 B 多端问题排查手册
卷四附录 B:按十类症状组织多端排查手册,包括功能在某端不可用、同一笔订单状态不同、组件样式漂移、发布后白屏、性能退化、线上问题无法定位、第三方 SDK 隐私风险、区域格式错误、读屏不可用与迁移卡住;每类给出先查什么、常见根因、验证方式与预防动作。
tag
卷四附录 B:按十类症状组织多端排查手册,包括功能在某端不可用、同一笔订单状态不同、组件样式漂移、发布后白屏、性能退化、线上问题无法定位、第三方 SDK 隐私风险、区域格式错误、读屏不可用与迁移卡住;每类给出先查什么、常见根因、验证方式与预防动作。
同样的提示内容只调整块顺序,可缓存前缀从 594 token 变成 1,354 token,百次请求的输入成本从 29,300 微元降到 12,200 微元。本节说明前缀缓存的命中条件、失效边界与“可缓存形状”,并给出可运行的前缀分析模块与示例样本运行结果。
《泡泡工坊》没有全球单世界的包袱,也没有竞技产品的延迟硬约束:本文复盘北辰如何用单区域多可用区、无状态大厅加专用房间和 CDN 把休闲产品送出海,给出部署形态评分、区域筛选与月度成本估算的可运行 Go 实现,并说明什么情况下坚决不上多区域,以及多区域的升级门槛。
卷四附录 A:把承诺、边界、能力、性能、稳定性、交付、可观测性、安全、国际化、无障碍、治理与迁移十二组核心术语与判据压缩成速查表,每项给出定义、判断条件、常见误用与对应章节;另附一页纸十二问与中英术语对照,便于架构评审、跨团队对齐与新人上手时直接引用。
从「回声」一次账单翻三倍的扩容说起,拆解输入 token 的四类来源、历史每轮重发带来的近似二次增长,以及上下文长度对成本与首字延迟的不同曲线;文中给出可运行的 TypeScript 统计模块、示例样本上的运行结果,并说明它与卷一上下文预算的分工。
《群岛纪元》要的是全球单世界,而不是把玩家分开:本文复盘北辰如何在地图分片、联盟跨时区、王战时间窗与数据驻留之间取舍,给出世界分区、联盟归属、扫描预算、状态迁移与六组表驱动测试的可运行 Go 实现,并说明如果重做一次,哪些全球社交功能会被降级为只读汇总。
四卷一百八十节讲完,真正要留下的是一个能自查的承诺模型,而不是一份读完的目录。本节把四卷的核心问题整理成十五项收官检查表,用覆盖率与未关闭项生成下一步建议,并给出继续演进、转入巩固与冻结架构三类停止条件,帮助读者判断什么时候该停下来、什么时候只需维护。
从「回声」大客户挤占小客户容量的投诉出发,讨论多租户共享推理容量时的加权公平队列、饥饿防护、租户配额与突发额度。文中给出可运行的 TypeScript WFQ 与令牌桶模块,并在三租户确定性样本上给出无防护与 200ms 防护两种配置的真实运行结果,说明公平份额与最坏等待之间的取舍。
从一次「把并发调大就好了」的线上误判出发,说明并发上限如何用 Little 定律与目标利用率推导、信号量如何限制在途请求、背压如何向上游传播,以及降级与拒绝的本质区别。文中给出可运行的 TypeScript 信号量与压力决策模块,并在 240 条固定样本上对比无界队列、有界拒绝与降级三种策略的真实运行结果。
《裂隙战场》把赛区当成产品决策而不是机房清单:本文复盘北辰在延迟、赛事、观战与成本之间的四次让步,给出赛区候选打分、输入延迟预算、跨区判定、低峰赛区合并与六组表驱动测试的可运行 Go 实现,并说明如果重做一次,哪些跨区匹配会被直接放弃、哪些低峰成本不再摊薄。
从「回声」早高峰的排队投诉出发,讨论有界队列、优先级老化与准入判据:为什么无限排队会把过载伪装成延迟,为什么纯优先级会让批量任务饿死,以及怎样用预估等待时间在入口直接拒绝。文中给出可运行的 TypeScript 队列与准入模块,并在 90 条确定性样本上比较 FIFO、优先级与老化三种顺序的真实运行结果。
《裂隙战场》一次 30% 灰度里错误率正常、退款率却先抬头,自动回滚没有触发。这一节把开关分成总开关、区服、玩法与白名单四级,给出区服、比例、房间类型、渠道四个灰度维度与放量节奏,并讨论错误率、延迟、客诉、经济指标各自的回滚判据和自动回滚的边界。
三份来自不同团队的压测报告往往无法比较,因为负载模型不同。本文用确定性 mock 推理器构造稳定、突发、长尾三种负载,产出一份不含时间戳、带指纹、可逐字段比对的基线报告,并给出把它当回归门禁的阈值与取舍;所有数字均为示例样本上的运行结果,不是生产实测。
平台化不是把组件数量堆上去,而是让承诺、组件、交付、观测、安全与治理六个维度都能拿出证据。本节用成熟度矩阵给每个条目打分,按缺口排名生成改进顺序,再用维度均值、单项底线、证据要求与加权总分四道门槛完成验收,并说明为什么平均分与权重都不能代替单项底线。
看板写着 40 QPS,用户却在超时:吞吐、并发与有效吞吐回答的是三个不同问题。本文给出 goodput 的 SLO 与窗口口径,用确定性批调度器展示并发饱和、批处理对 p95 的影响,以及吞吐几乎不变而 goodput 从 100% 跌到 28% 的取舍。
《群岛纪元》一次联盟字段改名,让回滚后的旧服务端读不到数据。这一节把兼容拆成新读旧、旧读新两个方向,给出扩、双写、收三阶段迁移的状态机与回填约束,用最长对局、最长离线与最长回滚时间取最大值来确定兼容窗口,并附可运行的迁移阶段、窗口计算与回滚判定代码。
同一笔已支付订单在 Web、iOS、Android、小程序和桌面回放,金额、状态与文案只要有一处不同,用户就会怀疑这笔钱去了哪里。本节用可运行的 TypeScript 场景脚本收集五端观测,把差异归为呈现、环境、契约与未知四类,并给出阻断、警告与放行的发布判据。
从用户只看到「转圈很久」的投诉出发,把流式推理拆成首字、单 token 与端到端三段:排队、冷启动、预填充各占多少,TTFT、ITL、TPOT 与 E2E 如何互相约束,预算为什么必须逐项签而不是取平均;附可逐条断言的 TypeScript 时间线模块与示例样本上的运行结果。
《裂隙战场》午夜重启断掉两百局对局之后,北辰把发版从“重启进程”改成“排空发布”。这一节比较房间、进程、区服三种发布单元的代价,给出停新进、等对局、超时强迁的状态机、分批顺序与活动日历约束,并讨论混版本时协议兼容、房间内一致与跨版本匹配的边界。
安全审计、支付、战斗和行为日志的保留期不同,冷热分层与不可改写要求也不同。本文按日志类别配置留存参数,讨论热存、冷存、归档与到期清理的边界,用追加写和哈希链检测篡改,说明取证导出时的授权分离、脱敏与清单摘要,并附 internal/auditretention 的 Go 实现与六组表驱动测试。