MongoDB 副本集读卸载:secondaryPreferred 换余量,不换写可用

Hello,我是小兔大白糖。 压测一上来,应用报 server selection timeout;拓扑里短暂看不到健康 Primary,Secondary 复制延迟飙高。第一反应常是:「上读写分离吧。」它能治什么、治不了什么?
写成这篇,给要做 MongoDB 副本集读卸载 / 读写分离选型调研 的初中级后端同学:钉的是公开可核对的 readPreference(读偏好) 与一致性边界,不是某云规格说明书,也不是某项目怎么改 Client 的工单。
说明:文中的路径分档、伪流程与数字均为教学脱敏 / 示意。readPreference 名称用 MongoDB 官方公开概念;驱动 API 形态因语言而异,只钉「在哪声明、付什么代价」。
估计阅读时间:10 分钟
目录
为什么现在要关心
硬规则一:写永远打 Primary;默认读也打 Primary——高压时 Primary 同时扛写+读,是常见过载形态。
硬规则二:把部分只读改到 Secondary(如 secondaryPreferred)只能用「更旧一点的数据」换 Primary 余量;消除不了「无 Primary 时写不可用」。
现场里「上读写分离」这句话,常常混了三件不同的事:
| 你以为在治 | 实际在动的旋钮 |
|---|---|
| 选服超时 / 短暂无 Primary | 负载 + 选主窗口 + 选服超时叠加——弱读救不了写 |
| Primary CPU / opcounters 冲高 | 读写默认都挤 Primary——弱读有机会减读压力 |
| 「分离了就能扛选主」 | 写仍依赖 Primary;分离只改变读的落点概率 |
同站若已写过背压、限流一类「治本」手段,读卸载是旁路减负:它不替代升配、索引、消 N+1、限流。本文只钉一件事——什么路径可以弱读、在哪声明、付什么陈旧度代价。
问题空间:卸载的是读,不是写
先问「我要减的是 Primary 上的只读压力,还是要在选主窗口里继续写」;答错题,换什么 preference 都像在治错病。
| 现象层 | 常见真相 |
|---|---|
| 选服超时 / 短暂无 Primary | 负载 + 选举窗口 + 客户端选服超时叠加 |
| Primary CPU / 读写计数冲高 | 默认 primary 下读也打写节点 |
| 以为读写分离能扛选主 | 写仍依赖 Primary;分离只减读压力的概率 |
| Secondary 也打满却只怪 Primary | 读卸载成功后,瓶颈挪到复制集另一侧 |
根因常是:规格与查询成本下的负载过高 × 读集中 Primary;不是某一个 opcounter 数字本身是红线。读卸载改变的是「读去哪」,不是「没有 Primary 也能写」。
非目标先说清(选型时可贴在评审页顶上):
- 不替代升配、索引、消 N+1、限流。
- 不保证选主期间写成功。
- 不自动让 Secondary 永不过载。
心智模型:柜台记账本 vs 复印本
主比喻:银行网点。
- Primary = 柜台记账本:入账、改余额必须在这本上写。
- Secondary = 隔壁柜员手里的复印本:可以去那边核对流水,但可能还差几页没印完。
类比局限一句说清:记账本 / 复印本解释「写落点」和「读可能陈旧」;解释不了选主窗口——那时柜台暂时没人,复印本也救不了写。
公开机制:readPreference 一眼表
默认 primary:读最新、压力集中;secondaryPreferred 是最常用的读卸载偏好——有 Secondary 就读它,否则回退 Primary,代价是可能读到复制滞后的旧数据。
| 偏好(官方概念) | 人话 | 代价 / 边界 |
|---|---|---|
| primary(默认) | 读打写节点,通常看到最新 | Primary 易成读写合瓶颈 |
| primaryPreferred | 优先 Primary,不可用才去 Secondary | 平时仍挤 Primary;可用性窗口才弱读 |
| secondaryPreferred | 有 Secondary 则读它,否则回退 Primary | 可能读到滞后数据;常用 offload |
| secondary | 只读 Secondary | 无可用 Secondary 则选服失败;陈旧度硬 |
| nearest | 偏网络延迟选成员 | 成员角色与陈旧度要单独评估 |
| maxStalenessSeconds(可选约束) | 限制可接受的最大复制滞后 | 需对照当前驱动与部署文档矩阵 |
硬提醒(产品语义,不是驱动开关):
- 未读数、余额、「刚写完立刻读」 一类路径,默认别弱读。
- 弱读换的是 Primary 余量;换不来「永远新鲜」。
- 全局把连接串改成
secondaryPreferred,最快,也最容易误伤写后读。
教学示意(非某语言 SDK;合计数行):
# 全局 Client:默认 primary(强读)
client = connect(uri) # readPreference=primary
# 单次只读查询:允许陈旧时挂 secondaryPreferred
find(coll, filter, readPreference=secondaryPreferred)
# 写后读 / 账本类:保持 primary,不要「图省事」继承弱读
find(coll, filter, readPreference=primary)业界落点:弱读声明在哪一层
常见主战场是 DAL / Repository:与查询共存、审查直观;全局 URI 一刀切不推荐当默认。
| 落点 | 优点 | 代价 |
|---|---|---|
| API / Handler | 与产品语义对齐「整接口可旧」 | 易漏;同一接口混强/弱读时难管 |
| DAL / Repository | 与查询共存;可拆「强读方法 / 弱读方法」 | 被多处调用时必须参数化或拆方法 |
| 全局 URI 改 secondaryPreferred | 改得快 | 误伤写后读路径;不推荐当默认 |
推荐组合(业界常见做法归纳,不是某厂内幕):
- 全局 Client 默认
primary。 - 弱读挂在单次 Find / Aggregate(或等价)上,而不是改整条连接串。
- 产品门禁决定「这条路径允不允旧」——技术开关服从产品语义。
单 Client + 操作级 preference vs 双 Client:前者通常够用;双 Client 连接与池翻倍,仅在偏好冲突极高、审查成本压过连接成本时再考虑。代价先说清:弱读路径省了 Primary 读,却引入滞后可见性与「写后读不一致」的产品风险——稳的是路径级语义,不是「上了分离就稳了」。
验收时建议并行看三件事(示意,非 SLA):Primary 压力是否下降、复制 lag 是否可接受、敏感路径正确性是否仍在。
常见坑
从架构视角看,下面几条会把「读卸载」用成「假装解决了写可用」。
-
全局改 URI 弱读
写后读看到旧值,产品事故。改得快,炸得也快。 -
敏感路径弱读
未读数、账本、权限判定、「刚写入立刻展示」——这些用复印本对账,等于主动接受错账窗口。 -
以为分离能修无 Primary
选主窗口写仍失败;弱读最多让只读接口多撑一会儿。 -
Secondary 也打满却只怪 Primary
读卸载成功后,瓶颈会搬家;只盯写节点会误判「分离没用」。 -
无观测:分不清弱读错误率与复制滞后
看板缺 lag、路径级错误率与「强读/弱读」分流,排障只能猜。 -
用读卸载替代治本
缺索引、N+1、无界并发仍在,只是把火力从 Primary 分到 Secondary——两边一起热。
选型结论
- 两条硬规则先钉死:写与默认读都挤 Primary;弱读只换陈旧度换余量,不换写可用。
secondaryPreferred是常用 offload;敏感路径保持primary。- DAL 操作级 preference + 产品门禁;别全局 URI 一刀切。
- 与治本手段并行:升配、索引、消 N+1、限流——读卸载是旁路,不是主药。
- 验收看三列:Primary 压力、复制 lag、路径级正确性;缺观测就别宣称「分离已上线」。