首页/数据/NoSQL 速查/rs.stepDown 主动主从切换
MongoDB99 条

rs.stepDown 主动主从切换

让主节点主动退位触发选举,便于滚动维护;stepDown(60) 表示 60 秒内不参与竞选,为新主节点让路。

NoSQL 速查数据更新于 2026-10-12
语法rs.stepDown(seconds)
效果强制选举,主节点转移到其他合格成员
配合应用需具备重试能力(retryable writes 默认开启)

示例

示例
rs.stepDown(60)
db.hello().isWritablePrimary
切换窗口内应用可能出现短暂写失败,需依赖驱动重试与合适超时设置。

易错点

  • 单节点复制集无法切换主从;没有可竞选节点时 stepDown 会直接失败

数据来源与参考

  • MongoDB Manual: rs.stepDown()
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌