
Hello,我是小兔大白糖。 列表接口看着是「读」,压测一上量却把共享库写带宽打红——根因常常不是索引坏了,而是读路径上顺手刷了访问字段。写成这篇,给要做 读路径副作用写(read-path side-effect write) 心智模型调研的初中级后端同学:先分清借阅与盖戳,再谈削峰组件。
同站分工一句话:请求放大审计 管「每请求次数与体积」;热计数 Write-Behind 管「写策略怎么选」;Mongo × OTel 审计 管「怎么量、怎么不说谎」;本文管 读请求不该不经意变成写请求。
估计阅读时间:9 分钟
目录
为什么现在要关心
硬规则一:热读路径默认只读;访问统计不得在请求关键路径上对大批量 id 做同步批量更新。
共享文档库 / RDBMS 上,一次「看起来是读」的 API 常在背后做这些事:
| 你看到的 | 背后常在干的 |
|---|---|
| 列表查出 N 条后变慢 | 立刻批量刷「最近访问时间」 |
| 身份校验 / 地图打点偶发写压 | 详情 hydrate 顺带 enqueue tracking |
| 后台空转仍高频扫库 | poller 把空结果当「要更勤」 |
| 后端减负后库仍红 | 外部批处理与在线热读抢同一写带宽 |
用户体感是「读接口变慢」;根因往往是 读路径副作用写 把写风暴叠进热读。这和「请求放大」相邻,但焦点不同:放大管次数与体积;本文管读不该变成写。
可复述硬规则(删掉比喻也成立):
- 热读路径默认只读——
last_seen、访问统计、tracking 不得在 GET/list 关键路径上对大批量 id 同步UpdateMany一类批量写。 - 要写就窗口化 + 有界写回——去重窗口、pending 队列、小批量 flush;缓存失败可 fail-open,但不能把热路径打回裸批量写。
- 慢查询 shape 消失 ≠ 路由 P95 达标——机制说明与实测数字必须分窗;勿用代码 diff 假装成 benchmark。
心智模型:借阅 vs 盖戳
主比喻:图书馆柜台。
| 类比 | 含义 | 适合回答 |
|---|---|---|
| 借阅(读) | 把书递给读者 | 这次调用该不该碰写路径 |
| 盖「今日来过」戳(副作用写) | 每借一本就在总台大账本改一行 | 为什么热读会制造写风暴 |
| 门口「待盖戳篮子」+ 定时小批量 | 有界队列 + 窗口化 Write-Behind | 访问统计默认怎么落 |
| 身份核验通道明确不盖戳 | NoTrack 旁路读 | 校验 / 聚合接口要不要计访问 |
一句话:读者一多,柜台往往不是被「递书」堵死,而是被「盖戳」堵死。
类比局限:这套比喻解释调度与削峰形状;解释不了「盖完戳后 P95 降了多少」——那要路由墙钟与请求级写命令合计,尺子见 Mongo × OTel 审计。有界队列与落盘延迟合同,细节另见 热计数 Write-Behind。
精确定义:读路径副作用写
把「读接口慢」拆成可勾选红灯:是不是在读的关键路径上写了库。
| 术语 | 人话定义 | 边界 |
|---|---|---|
| 读路径副作用写 | 用户可见语义是读(list / get / resolve),实现却在同一请求(或紧贴其后的无界异步)里对热字段做批量写 | 不含产品明确要求的「读即锁」「读即占座」等写语义合同 |
| 热读路径 | 高 QPS、与用户墙钟绑定的 GET/list/brief | 后台 job、运维脚本另算,但仍要控写带宽 |
| 窗口化 Write-Behind | 去重窗口内同一 id 只入队一次;后台小批量 flush;失败可回队 | 换来落盘延迟、至少一次、队列积压——见姊妹篇 |
| NoTrack 旁路读 | 身份 / 地图 / 聚合等窄读接口明确不 enqueue、不刷访问字段 | 产品要接受「此处不计访问」 |
补充边界:
- 请求内
go打批量写:返回变快了,写风暴与失败语义往往还在——多数只是把同步写换成了难控的无界异步写。 - 切块 + 投影收窄:大
$in/ 大IN切块、窄 projection、可用索引——治的是读形状与写包体积,替代不了「别在热读上同步刷访问」。 - poller 空转退避:idle 可指数/阶梯退避;错误不得当 idle——故障时越等越久是另一类事故。
常见模式对比
热访问字段默认调研模式 C;旁路读用 D;禁止把 A 当生产默认。
| 模式 | 做法 | 代价 | 适用 |
|---|---|---|---|
| A. 读后同步刷字段 | FindMany → 批量 Update(accessed_at) | 实现简单;热读直接制造写风暴 | 仅低 QPS / 单机玩具 |
| B. 请求内异步裸写 | 返回前 go 打同一批 Update | 仍可能对同一批 id 风暴;难控失败与背压 | 过渡期,仍危险 |
| C. 窗口去重 + Write-Behind | 窗口键 + pending + 后台小批量 flush | 多一层组件;要处理 flush 失败回队与落盘延迟 | 生产热读统计默认 |
| D. 读路径 NoTrack | 窄读接口明确不 enqueue | 产品接受「此处不计访问」 | 校验、聚合、旁路读 |
| E. 切块 + hint / 投影 | $in 切块、强制可用索引、窄 projection | 要维护索引与 chunk 大小 | 大 $in / 混读治理 |
| F. poller 空转退避 | idle 指数/阶梯退避;错误≠idle | 要区分空与故障 | 后台 claim/list 循环 |
教学倾向:热访问字段用 C;旁路读用 D;大集合查询配 E;后台循环配 F。模式 C 的写策略选型细节交给 热计数 Write-Behind;本文只钉死:热读关键路径上不要留 A/B。
示意伪流程
先返回读结果;访问统计走窗口入队,不走同步批量写。
教学伪流程(示意,非某框架 API):
热读 API
→ FindMany(窄 projection)
→ 响应返回
→ 若需访问统计:窗口 SET NX;未命中则入 pending
→ 后台:小批量 pop → UpdateMany;失败则回队
旁路读(身份 / 地图校验)
→ Resolve*NoTrack:不 enqueue、不 UpdateMany反例(同一热路径):
FindMany(200 keys)
→ UpdateMany(accessed_at, $in=200) // 同步或裸 go
→ 同一接口每秒上千次 → 写风暴分享向代码到此为止:删掉围栏,上面硬规则与模式表仍应成立。每请求往返次数与体积的放大病征,另见 请求放大审计。
证据口径
代码路径变化可以先写 overview;实测数字另开窗口。勿用 diff 假装成 benchmark。
| 证据 | 能证明 | 不能证明 |
|---|---|---|
| 慢日志按 shape 聚类 | 哪类写/读在打库 | 用户 API P95 |
| Trace 上「一次 HTTP 多少 DB 命令」 | 读路径是否夹带写 | 部署后整体变快多少 |
| 代码 diff / 机制说明 | After 路径变了 | 实测减负 |
| 部署后 frozen window delta | count / maxMs、COLLSCAN 是否消失 | 单靠「慢日志没了」宣称达标 |
报告建议分两档:
- 机制说明:Before 路径夹带写 → After 窗口化 / NoTrack;可附伪流程与 diff 摘要。
- 实测 delta:固定时间窗、分母(QPS / 路由样本量)、写命令合计与路由 P95——尺子与「禁止混表说谎」见 Mongo × OTel 审计。
常见坑
从治理诚实度看,下面几条会把「改完路径」直接写成「优化完了」。
-
把 tracking 挂在「所有读到实体的地方」
旁路校验、地图聚合也被计访问并写库——先提供 NoTrack 变体,再谈统计覆盖率。 -
flush 失败丢了队列却清了去重键
静默丢更新,或窗口一过立刻再风暴。失败要回队;去重键生命周期要与 pending 合同对齐。 -
poller 把 claim 报错当成 idle 退避
空结果可退;故障越等越久是另一类事故。错误与 idle 必须分叉。 -
请求内
go当「已经异步化」
无界、无背压、难观测——多数只是把同步写藏进了进程生命周期。 -
外部 ETL 写压与在线热读同库
后端减负后库仍红,要分账移交数据侧——别全算在 API 优化头上。 -
用「慢日志 shape 消失」宣称路由达标
shape 变了只证明打库形态变了;P95 要另开实测窗。
选型结论
- Review 热读 PR:搜批量 Update 是否出现在 GET/list 路径;出现即红灯,除非有明确写语义合同。
- 访问类字段默认窗口化 Write-Behind;旁路读提供 NoTrack;禁止把同步刷字段当默认。
- 大
$in/$or切块 + 索引 hint;Count 类用短 TTL + singleflight——治读形状,不替代「热读不写」。 - 报告分两档:机制说明 vs 实测 delta;后者必须有分母与时间窗。
- 共享库上的批处理写压单独记账,别全算在 API 优化头上。
- 同站导航:请求放大 找次数与体积;Write-Behind 选写策略;OTel 审计 量病;本文钉 读路径不写。
读完若只能转发一句,请转发这句:热读默认只读;要盖戳,就窗口化、有界写回——别在递书的柜台上同步改大账本。