Secondary读到旧数据是因未配置maxStalenessSeconds，该参数控制最大可接受延迟（单位秒），仅对secondary/secondaryPreferred/nearest生效；设为-1不限制，0则报错；需结合心跳状态、节点slaveDelay及事务限制综合判断。
Secondary读到旧数据，不是配置错了，而是readPreference没配maxStalenessSeconds
默认的 secondary 或 secondaryPreferred 读取偏好不保证数据新鲜度，它只管路由到Secondary节点，不管这个节点落后Primary多久。你查到的数据可能已延迟数分钟甚至更久——这不是bug，是设计使然。
真正控制“最多能接受多老的数据”的参数是 maxStalenessSeconds，必须显式设置，且只对 secondary、secondaryPreferred、nearest 生效；primary 和 primaryPreferred 忽略它。
- 连接字符串中加：
mongodb://host1,host2/?replicaSet=rs0&readPreference=secondary&maxStalenessSeconds=30（最多容忍30秒延迟） - PyMongo 中写：
find({}, read_preference=ReadPreference.SECONDARY, max_staleness=30)，注意单位是秒，不是毫秒 - Node.js Driver 中：
collection.find({}).readPreference('secondary', { maxStalenessSeconds: 30 }) - 值设为
-1表示不限制延迟（等同于不设），设为0会直接报错：驱动拒绝接受零延迟要求
为什么maxStalenessSeconds设了还是读到旧数据
这个参数生效的前提是：驱动能准确知道每个Secondary节点的“最新同步时间”。而这个信息来自节点定期上报的 optime 和心跳响应。一旦网络抖动、节点短暂失联或 lastHeartbeatRecv 异常，驱动就可能沿用过期的延迟估算值。
- 检查
rs.status().members[n].lastHeartbeatRecv是否在持续更新；如果停滞，说明该节点心跳异常，驱动可能已将其剔除出候选列表 -
maxStalenessSeconds的计算基准是“所有符合条件节点中optime最老的那个”，不是你连的那个节点单独算——哪怕你指定某台Secondary，驱动仍会按全局最差情况判断是否满足阈值 - 该参数不强制节点“追上”，只做路由过滤：如果当前所有Secondary都落后 >30秒，
secondary模式会报错，secondaryPreferred则自动 fallback 到 Primary
Secondary节点本身被配置为延迟同步，maxStalenessSeconds无效
如果副本集成员配置了 slaveDelay（比如 "slaveDelay": 3600），那它天生就比Primary少一小时数据。此时无论你把 maxStalenessSeconds 设成多少，只要小于3600，这个节点就永远进不了读取候选池。
- 查配置：
rs.conf().members[n].slaveDelay，非0值即表示人为引入延迟 - 这种节点通常用于误操作恢复场景，不适合常规读负载；若业务需要低延迟读，应避免将其加入读取偏好候选
- 即使它状态是
SECONDARY且health: 1，驱动也会因maxStalenessSeconds不达标而跳过它——你看到的“读不到”，其实是被静默过滤了
事务里切Secondary读，maxStalenessSeconds被无视
任何包含在事务中的读操作，MongoDB强制使用 readPreference=primary，且完全忽略 maxStalenessSeconds 和所有其他读取偏好设置。这不是限制，是因果一致性的硬性要求。
- 如果你在事务里调
find().readPreference('secondary')，驱动会静默降级为primary，不会报错也不会警告 - 想验证是否真走Secondary？在事务外单独执行相同查询，对比
db.currentOp()中的host字段 - 业务上若需“近实时但可容忍少量延迟”的读，应拆出事务范围，用带
maxStalenessSeconds的普通查询替代
真正决定Secondary读数据新旧程度的，从来不是节点状态是否为 SECONDARY，而是 maxStalenessSeconds 与节点实际 optime 的实时比对结果——这个比对发生在每次查询前，且依赖心跳和拓扑刷新的准确性。漏掉其中任一环，配置就形同虚设。
