《后端架构设计·演进与治理》附录 C 上线治理检查清单
上线前按六类治理动作逐项检查:拆分与边界、契约与兼容、观测与 SLO、混沌与发布、租户与安全、平台与成本。每项给出要留下的证据、通过条件、失败后的回退动作、责任人与复核周期,并附发布类型矩阵、一页式评审表、发布后 24 小时复核与证据留存要求。
tag
上线前按六类治理动作逐项检查:拆分与边界、契约与兼容、观测与 SLO、混沌与发布、租户与安全、平台与成本。每项给出要留下的证据、通过条件、失败后的回退动作、责任人与复核周期,并附发布类型矩阵、一页式评审表、发布后 24 小时复核与证据留存要求。
卷三附录 C:把单主复制切换、跨分片下单、重复消费、锁过期、时钟回拨、对账收敛六类场景写成可执行验证,每类给出前置条件、注入手段、观测信号、判定不变量、通过标准与回滚方式,并附上线前二十条检查、三态判定口径、演练顺序、数字口径与执行记录模板。
把卷四的治理组件放到 Go 1.26 与 Java 21 两种运行时里做结构对照:配置与开关、指标与上下文、限流与并发、健康检查与优雅停机、金丝雀状态机与策略求值,说明哪些能力来自语言、哪些来自框架,并明确 Java 代码为未在本机运行的示例。
卷三附录 B:只做结构对照,不排名。覆盖 goroutine 与虚拟线程的调度和阻塞语义、CompletableFuture 与 context 的取消传播、ReentrantLock 与 sync.Mutex 的重入差异、Clock 与 time.Time 的单调时钟、ConcurrentHashMap 与 sync.Map 的适用边界,以及分布式 ID、租约、重试的库生态差异。
把卷四 13 章的判据压缩成可查表:拆分触发条件与退出条件、契约兼容矩阵、服务发现与网关参数、配置与开关分类、SLI 与错误预算、混沌演练、发布阶段、租户隔离、平台能力与成本归因,每张表都给出阈值来源、证据要求、失败回退动作与正文对应章节,便于评审时逐项核对。
卷三附录 A:用判据、反例与业务映射三种口径整理线性一致、顺序一致、因果一致、读己之写、单调读和最终一致,说明崩溃停止、崩溃恢复、消息丢失、重复、分区与拜占庭六类故障语义,纠正 CAP 与 PACELC 的常见误读,并给出订单、库存、支付不变量到最弱一致性模型的对照表。
四卷收口篇把前三卷与卷四的能力整理成一张可校验的覆盖矩阵:用 L0 到 L3 的成熟度和文档、测试、演练、遥测四类证据约束声明,用依赖图与环检测排出路线顺序,并拒绝过期或越级的证据;给出可运行的 Go 校验器、跨四卷的示例矩阵与真实测试输出,最后说明这套治理如何持续运转。
卷三的 L2 实验只能证明状态机和故障处理,不能证明共识性能、跨单元冲突率、演练覆盖和组织成本。本节把四类未证明假设整理成带责任、指标、阈值、窗口和截止日期的交接表,并给出一个 Go 校验器,拒绝没有验收口径、缺少截止日期或把未证明项标成已接受的清单。
订单在 3 号分片、库存在 7 号分片时,本地事务失效。本节用进程内 L2 实验跑通 outbox + Saga 下单链路,注入重复投递、提交后超时、relay 崩溃和支付拒绝,断言库存不超卖、订单状态与预占一致、支付不重复,并让对账任务把差异收敛到零。
订单库从 4 个分片扩到 5 个时,按用户取模会让八成键搬家。本节用可运行的 Go 分片实验比较取模与 rendezvous 路由,给出按用户查询与跨分片查询的边界、全局 ID 的时钟回拨保护、双写迁移的 journal 与切换门,以及只允许在切换前执行的回滚条件。
从 arch-lab 周五晚一次被 SLO 燃尽率拦下的发布切入,说明单窗口阈值为什么会放过慢泄漏,给出快慢双窗口、冻结窗口、样本下限与预算余量的 Go 门禁,再用带稳态断言和止损边界的混沌计划编排发布前演练,并用真实测试输出验证门禁与中止路径。
从 arch-lab 订单系统把库存与支付拆成两个进程内服务的一次演练切入,对比共享库、单体事务与端口补偿三种方案,给出带状态机、幂等预占、崩溃恢复和跨服务审计的 Go 实现,并用固定时钟与失败注入跑通支付失败补偿和两处崩溃点恢复的完整测试。
从 arch-lab 订单团队第 26 天用完整月预算的场景切入,说明预算预警、预测与耗尽日如何构成可解释的门禁,给出基于中位数绝对偏差的异常检测、责任团队解析的可运行 Go 实现,以及本机真实测试输出、评审判据与常见错误,全部附原始输出。
从一次只读降级后没人敢回切的订单故障出发,把 RTO 拆成依赖图上的关键路径、把 RPO 拆成已确认序号与副本序号的差,给出可运行的状态机、RPO 计算与 RTO 关键路径 Go 实现,附本机测试输出、演练脚本、验收表与回切前置条件,并明确跨机房数字必须由真实演练校准。
从订单支付状态在两个机房互相覆盖的具体故障出发,说明双向复制为什么必须先解决回环与归属,再谈冲突合并;给出带路径回环检测、归属校验和版本向量判定的 Go 副本实现,用本机测试覆盖 A 到 B 再回 A 的回环、重复投递、非归属写入、陈旧事件与并发版本,并附冲突处置决策表。
从一个单元故障却拖垮全局订单入口的场景出发,拆解单元化、同城双活与异地多活的隔离边界,给出带容量校验和故障影响计算的 Go 拓扑模型,用三组可运行测试对比单单元故障、双单元同时故障与仅备用单元故障时的写入阻塞、读到旧数据和冗余损失,并附拓扑选型决策表与退出条件。
从 arch-lab 结算服务预留 100 台、实际峰值只剩 60 台、每月白付 2400 元的场景切入,对比全按量、部分预留与过量预留三种方案,给出覆盖率、闲置率与盈亏平衡利用率的 Go 计算模型、闲置回收排序、判据表与可复现的真实测试输出。
从 arch-lab 一张 5500 元账单里 23.6% 找不到负责人的场景切入,说明租户、服务、环境、负责人四个归因维度为何是分摊契约,给出保留未分摊桶、按驱动量拆分共享池的 Go 实现,并用固定账单数据实测归因结果、最大余数分摊与单位经济。
用 1000 个延迟任务对比最小堆与 64 桶时间轮的排序结果和扫描成本,实测 heap 16997 次比较、wheel 4416 次检查;给出按 next、now、间隔与上限计算 misfire 补偿的 Go 实现,覆盖补跑一次、跳过与大规模补跑上限的边界。
从 arch-lab 平台周报里 66% 的采纳率被拆成 38% 的席位加权率这一具体场景切入,说明团队均值这个数字为什么会被小团队放大,如何把未采纳原因、迁移成本、退出成本与回收期放进同一张记分卡,并给出可运行的 Go 实现与本机真实测试输出。