$out操作必须路由到主节点执行,因从节点无写权限,MongoDB≤4.4中其语义等价于drop+insert,属写入型阶段;即使显式设readPreference=secondary,驱动或mongos仍强制转发至主节点。

$out 操作必须路由到主节点执行,从节点不支持写入,这是 MongoDB 副本集的底层设计约束。即使你显式指定 readPreference=secondary,只要管道中包含 $out,驱动或 mongos 会自动将整个聚合请求转发至主节点——不是“限制”,而是协议级强制行为。
为什么 $out 不能在从节点运行(MongoDB ≤4.4)
在 MongoDB 4.4 及更早版本中,$out 阶段被定义为「写入型聚合阶段」,其语义等价于 db.collection.drop() + insertMany()。而副本集中只有主节点具备写权限,从节点默认以 secondaryOk=false 启动(即拒绝任何写操作)。此时若强行发往从节点,会立即返回错误:
WriteCommandError: not master
这不是配置问题,是角色隔离的硬性要求。即使你用 mongo --host secondary-host:27017 连上从节点并手动执行 db.collection.aggregate([{ $out: "target" }]),也会失败。
MongoDB 5.0+ 的 $merge 允许在从节点发起,但写入仍走主节点
从 MongoDB 5.0 开始,$merge 阶段支持在从节点上解析和调度,前提是:
- 集群所有节点的
featureCompatibilityVersion≥ 5.0 - 连接时明确设置
readPreference=secondary - 驱动版本支持该行为(如 Node.js driver ≥ 4.13)
但注意:$merge 的实际写入(插入/更新/替换文档)仍由主节点完成,从节点只负责读取源数据、构造更新命令、转发给主节点。所以网络延迟、主节点负载、写关注(w)配置仍直接影响整体耗时。
Compass 中 Insert Document 按钮禁用的常见误判
很多人看到 Compass 界面中 Insert Document 按钮灰色,第一反应是“连接没配好”,其实更可能是:
- 当前连接的确实是副本集从节点,且
Read Preference被设为Secondary或Nearest - 你使用的是 Compass Readonly 版本(无写入能力,连主节点也不行)
- 连接字符串里带了
&readPreference=secondary但没意识到它会锁死写权限
验证方法:在 Compass 左下角状态栏看当前连接的 host 是否含 PRIMARY 字样;或者打开 Shell,执行 rs.isMaster().ismaster —— 返回 true 才表示连上了主节点。
真正需要从节点跑聚合写入的场景,该怎么绕过限制
如果你的业务确实需要「从节点读 + 写结果到另一集合」(比如离线报表生成),有两条现实路径:
- 用
$facet或$bucket在从节点完成计算,再用应用层把结果insertOne()到目标集合(目标集合可位于任意节点,只要连接主节点即可) - 改用
$merge并确保驱动和 FCV 符合 5.0+ 要求,同时接受它本质仍是主节点写入的事实
别试图 patch mongod 或修改副本集角色——从节点没有 oplog 写权限,也无法保证写入原子性,强行绕过只会导致数据不一致。











