MongoDB副本集节点标签需通过rs.reconfig()动态配置tags字段，readPreference必须配合readPreferenceTags才能定向路由，Java驱动需用TagSet.builder()正确构造且全局唯一性至关重要。
怎么在MongoDB副本集里给节点打标签
副本集节点标签不是靠图形界面点出来的，得进每个节点的配置文件改 rs.conf() 里的 tags 字段，改完还得用 rs.reconfig() 热更新——直接改配置文件重启不生效。
常见错误是只改了 mongod.conf 里的 replication.tags，但 MongoDB 实际不读这个；或者改了配置却忘了调用 rs.reconfig()，导致 rs.status() 里看不到 tags 字段。
- 先连到主节点，运行
rs.conf()查看当前配置结构，找到目标节点的_id - 构造新配置：在对应节点对象里加
"tags": { "region": "shanghai", "role": "analytics" } - 执行
rs.reconfig(newConf, { force: true })（如果主节点不可用，force: true是必须的） - 再跑一遍
rs.conf()确认tags已写入，且rs.status()中该节点字段同步更新
readPreference 设置为 secondaryPreferred 后为啥没走带 tag 的从节点
因为 readPreference 本身不识别标签，必须配合 readPreferenceTags 才能定向。单独设 secondaryPreferred 只是“优先读从库”，但选哪个从库完全随机，不会看 tag。
典型场景是想让报表查询固定落到高配、低负载的分析专用从节点上，这时光靠读偏好级别不够，必须显式声明约束条件。
- 驱动层设置示例（Node.js）：
readPreference: 'secondaryPreferred', readPreferenceTags: [{ region: 'shanghai', role: 'analytics' }] - 多个 tag 组合时，MongoDB 会按数组顺序尝试匹配：第一个对象全字段命中才选，否则试下一个对象
- 如果所有
readPreferenceTags都不匹配，且readPreference是primaryPreferred或更低级别，就会 fallback 到主节点或任意可用节点 - 注意：Java 驱动里叫
readPreferenceTags，Python PyMongo 里是tag_sets，拼写和格式略有差异
为什么 rs.reconfig() 执行后节点状态变成 STARTUP2 或 ROLLBACK
这是 reconfig 触发了副本集重新选举或同步重置，尤其当新配置中某个节点被移出 members 数组、或 priority 被调成 0 但没关 hidden 时，容易让集群误判成员可用性。
更隐蔽的问题是：你给节点打了 { env: 'prod' } 标签，但其他节点也打了同样 tag，结果所有从节点都满足 readPreferenceTags 条件，驱动就随机挑一个——你以为定向成功了，其实只是运气好。
- 检查
rs.status().members中每个节点的stateStr和lastHeartbeatRecv，确认没节点失联 - 确保标签值全局唯一，或至少在你期望的读取路径下唯一（比如
{ region: 'shanghai', type: 'reporting' }比单个{ role: 'reporting' }更稳妥） - 避免在生产环境高频调用
rs.reconfig()，每次调用都有短暂不可用窗口，建议提前在测试环境验证配置结构合法性
Java Driver 里 readPreferenceTags 怎么写才不报错
Java 驱动对 readPreferenceTags 的类型校验很严：它不要 JSON 字符串，也不要 Map，而是要求 TagSet 对象数组，且每个 TagSet 必须用 Tag 构造——手写 new HashMap() 传进去会静默失效，日志也不报错，但实际请求完全不走 tag 过滤。
最容易被忽略的是：MongoDB Java Driver 4.x 和 3.x 的 API 完全不同，3.x 用 ReadPreference.secondaryPreferred().withTagSet(...)，4.x 改成 builder 模式，漏掉 .build() 就等于没设置。
- 正确写法（Driver 4.11+）：
ReadPreference.secondaryPreferred(ImmutableList.of(TagSet.builder().add("region", "shanghai").add("role", "analytics").build())) - 别用
TagSet.create(...)，它只接受单个Tag，不支持多 key - Spring Boot + MongoAutoConfiguration 下，不能只在
@Bean MongoProperties里配，得在MongoClientSettings构建时手动注入ReadPreference
标签不是魔法开关，它只在读操作里起作用，写永远走主节点；而且一旦配置错一条 tag 值，整个读请求就会降级，连 debug 日志都未必提示你 tag 匹配失败了。
