posts
这里是全站文章的归档入口，下面是按时间倒序排列的全部文章。若想按主题浏览，请从首页的专题分类进入。
SQL 散落在服务层会让事务、错误码和测试都变得难以收口。本节把图书、会员、借阅三类 SQL 收进 JdbcBookRepository、JdbcMemberRepository 与 JdbcLoanRepository，用行映射还原 record，并把 SQLState 翻译成 libraryd 的 ErrorCode。
同一条消息可能因重连补发、重试或多路径到达两次，晚到的消息也可能插到已经读过的位置。本节区分消息 id 与序列号，给出端上的去重集合、乱序缓冲窗口与冲突判定，并用可运行代码证明端上只能保证最终有序，不能保证实时有序，还会说明窗口边界与冲突上报为什么决定了故障是否可观测。
每条请求都新建物理连接会拖慢 libraryd，也很快耗尽 PostgreSQL 的连接数。本节用 HikariCP 建立有界连接池，讲清 maximumPoolSize、connectionTimeout、maxLifetime 与 leakDetectionThreshold 的含义，并用真实日志定位连接泄漏和池耗尽。
断线在移动端是常态。本节把重连拆成失败分类、指数退避、抖动与上限四个决策，给出一个可测试的纯函数退避模块，并复盘一次服务端重启后所有客户端同时重连、把网关打满的事故，最后说明网络从离线恢复时为什么要立即重连并清零计数，以及如何用确定随机源验证风暴是否真的被摊开。
libraryd 从内存仓储走向 PostgreSQL，第一步是把 JDBC 的四个对象用对：DriverManager 与 DataSource 的取舍、PreparedStatement 的参数绑定、ResultSet 的列读取，以及生成键与资源关闭。本节用真实容器跑通图书和借阅记录的写入与查询。
以 arch-lab 订单创建为样本，对照同步预留加通知与 outbox 异步发布两条路径，用 200 单真实 go test 量化用户等待和一致性延迟，并列出可异步步骤、绝不可异步步骤，以及失败可见性、补偿、对账与积压治理的代价，附本机单次运行数字。
在 arch-lab 的订单商品快照读路径上实现 singleflight、空值缓存、TTL 抖动和热 key 本地副本，用 200 个并发请求真实对比无保护与合并回源的回源次数，并说明每道保护的副作用、可观测指标、关闭条件与本机真实测量输出。
在 arch-lab 的订单商品快照写路径上实现 cache-aside、版本底线与删除重试队列，用两个测试复现“更新库后删缓存失败”和“并发读写把旧值回填”的窗口，比较双删、版本号与逻辑过期的代价，并给出带可观测指标的退出条件与适用边界。
给规模定四条软告警阈值：可达状态数 > 1e7、单次 BFS > 120 秒、峰值内存 > 4 GB、单条路径步数 > 40。当前规格四条全未越（9895423 状态、58.6 秒、2147.1 MB、31 步）；把 flag 放大到 30 后越过三条，而内存那条在两次复跑里一次越一次未越，脚本恒 exit 0。
量叙事引擎的单位成本：单次 eval_cond 求值中位数 169.9 ns，一次完整 BFS 32 层 9895423 状态、峰值 frontier 2498621、19121205 次求值、60.8 秒、峰值内存 2153 MB。给出求值次数与规格规模的比值，并声明所有耗时都是本机 proxy，只做相对比较。
把同一份规格沿 flag、好感度、物品、节点四条轴分别放大一档，量 20 层内可达状态数与枚举耗时的增长：flag 18→30 时声明空间上界涨 4096 倍，实测可达只涨 2.096 倍；好感度轴单位倍率最高也只有 1.1285，远低于声明域的 101。给出规模表、增长阶与一张纯 xml.etree 生成的 SVG 曲线。
实时通道会断，产品不能跟着白屏。本节把连接状态映射成角标、自动插入、输入中、评论框与在线状态五种能力，给出暂停、手动、排队、禁用四类降级模式与恢复顺序，让页面在弱网下仍能读缓存、写草稿、手动刷新；队列只接受可幂等重放的写操作，并复盘一次整页空白事故。
在 arch-lab 的订单商品快照读路径上实现带 TTL 与 LRU 的 L1 本地缓存和 L2 端口，用可注入时钟测试淘汰、过期与并发读写，再用 20 万次 80/20 请求测出真实命中率、回源次数，并给出容量规划、失效边界和并发测试的真实输出。
连接不是一个 connected 布尔值，而是 idle、connecting、open、reconnecting、closed、failed 之间的迁移。本节用可测试的状态机定义合法迁移、后退钩子、页面切后台与恢复、卸载清理，并复盘旧连接回调把新连接误标为 open 的事故。
卷三《叙事体验与路径度量》的附录：把度量侧的规格输入、六个代理指标的口径、五个定义式与本卷工作区的文件清单汇成一张可核对的总表，并给出可运行性命令与排错顺序。全部数字均来自本机实跑，随正文各章一并更新，便于在写新章节或修改叙事规格时随时对照、重跑与核对。
残差算出来了，可超过多少才算告警？本节把阈值写成一条显式策略：先算声明基数当分母，取它的四分之一作默认阈值，再把上一节的七种规格变异逐个判定；最后扫描阈值的取值区间，看清阈值过紧与过松各自把告警变成什么样。残差与残差率全部是代理指标，只做相对比较。
一致性残差只有能在规格改动后朝正确方向移动，才是可用的回归信号。本节在内存克隆上做七种规格变异——补声明域、给秘密与禁则加门、清掉立场提供者，以及一次故意的回归——把残差重算成一张回归表，再用修复阶梯与信任门两条扫描检查单调性。残差全部是代理指标，只做相对比较。
把「声明」与「行为」对齐后统计失配计数：声明来自角色的 affinity / secret、派系 stance 与规则，行为来自选项的 when / effects 与采样路径。本节把一致性残差量成四个整数——声明域 D、秘密 K、立场 S、规则 R，并沿 2000 条路径量路径实现率，全部显式声明为 proxy。
把每条「路径 × 变量」的曲线按整数规则分类成六种形状：平台型 / 单调上升 / 单调下降 / 先升后降 / 先降后升 / 震荡型。实测 5000 条路径 × 4 变量 = 20000 条曲线里，单调上升占 359‰ 最多、震荡型 181‰ 次之、单调下降只有 74‰。shen 的单调下降为 0 条、yan 的平台型为 0 条，这两处零值各有成因。
把 14 道好感度阈值门（13 条选项门 + 1 条结局门）抽平，定义路径触达为「变量沿路径最大值 >= 门限」。实测 5000 条采样路径里 18 条（3‰）从未触达任何门，yan>=25 的触达率最高 858‰。B 层把每道门限 ±10 后重走路径：14 道门全部改变了触达率，只打印软告警、exit 0。