mongos路由缓存不一致时只能全库刷新,因Catalog Cache是全局结构;唯一有效方式是db.adminCommand({flushRouterConfig:1}),该命令清空本地缓存并全量拉取最新路由表。

mongos 路由缓存不一致时,不能“强制刷新单个 collection”,只能全库级刷新或触发版本校验重试。 这是设计使然——Catalog Cache 是全局内存结构,没有 per-collection 的独立缓存实例。
db.adminCommand({ flushRouterConfig: 1 }) 是唯一真正生效的强制刷新方式
该命令会让 mongos 清空本地 Catalog Cache,并立即向 Config Server 全量拉取最新路由表(包括 config.chunks、config.shards、config.databases 等)。但它不是轻量操作:
- 会阻塞后续查询短暂时间(通常
- 对 Config Server 产生一次全量读压力,频繁调用(如每秒多次)可能导致其 CPU 或连接数飙升
- 它不区分 collection,执行后所有数据库+集合的路由信息都会重载
- 必须在 mongos 上执行,不能在 shard 或 config server 上运行
getShardVersion 是更安全的“按需探测+被动刷新”手段
相比 flushRouterConfig,getShardVersion 不清缓存,只做版本比对,并在发现落后时触发一次增量更新(类似自动重试的第一步):
- 执行
db.runCommand({ getShardVersion: "mydb.mycoll" })后,如果返回的version字段低于 Config Server 当前值,mongos 会立刻发起一次增量配置同步 - 这个过程不阻塞查询,也不加重 Config Server 负担,适合嵌入应用关键路径(比如分页查询前加一层校验)
- 返回中若含
"stale": true,说明当前请求已被路由到旧分片,且 mongos 已感知到不一致 —— 此时应丢弃结果并重试 - 注意:该命令必须指定完整命名空间(
"db.coll"),不能只写"coll"或省略 db
启动参数 --configRefreshIntervalMS 可压缩刷新窗口,但不能替代运行时干预
默认 30 秒轮询一次配置更新,迁移高峰期容易错过变更。调整间隔能降低概率,但无法消除脏缓存:
- 启动 mongos 时加
--configRefreshIntervalMS 5000(最小建议值),可将最大延迟从 30s 压到 5s - 该参数只影响后台定时拉取,不影响
getShardVersion或flushRouterConfig的即时行为 - 设得太小(如 1000)会导致 mongos 频繁发心跳请求,可能被 Config Server 限流或触发连接抖动
- 修改后必须重启 mongos 生效,无法热更新
真正难处理的不是“怎么刷”,而是“刷完之后应用是否还按旧逻辑走”——比如游标基于 created_at 分页,在缓存刷新间隙可能扫到重复数据;又比如写操作没建唯一索引,flushRouterConfig 后重试反而造成双写。这些都得靠业务层兜底,而不是指望 mongos 缓存变“绝对实时”。



















