MongoDB副本集域名变更后需手动重置配置，因local.system.replset硬编码旧地址；rs.reconfig()报错常见于非主节点操作、主机名解析失败或version未递增；极端情况下须停机清空replset表并重新initiate。
域名解析变更后，MongoDB 副本集不会自动更新成员地址，rs.status() 仍显示旧主机名，连接请求持续失败——这不是 DNS 缓存问题，而是副本集配置元数据（local.system.replset）里硬编码了旧域名，必须手动重置。
为什么 rs.reconfig() 会报错 “not master” 或 “NodeNotFound”
执行 rs.reconfig() 时，当前主节点拒绝修改配置，常见原因有三个：
- 你正在从一个非主节点（比如 SECONDARY 或 ARBITER）发起 reconfig 请求；必须先
rs.stepDown()让主节点退位，或直接连到当前主节点再操作 - 新配置中某个成员的主机名在本地 DNS 或
/etc/hosts中无法解析（哪怕只差一个字母或大小写），mongod 会在校验阶段直接拒绝加载 - 配置版本号（
version）没递增：新配置的version必须严格大于rs.conf().version，否则被判定为“回滚配置”，直接报错
如何安全地重置 local.system.replset 表
当 rs.reconfig() 彻底不可用（例如所有节点都卡在 STARTUP2、无法选出主节点），唯一办法是停机修改底层配置表。注意：这属于高危操作，仅适用于初始化失败、尚未写入业务数据的环境。
- 逐个停止所有 mongod 进程：
systemctl stop mongod（Linux）或net stop MongoDB（Windows） - 用
mongod --dbpath /var/lib/mongodb --repair确保数据目录可读（可选但推荐） - 启动一个单节点临时实例，绑定到空闲端口（如 27018），并禁用复制：
mongod --port 27018 --dbpath /var/lib/mongodb --bindIp 127.0.0.1 --nojournal - 连上去清空配置：
mongo --port 27018→use local→db.system.replset.remove({}) - 关闭该临时实例，恢复原配置文件，把
replSetName改成新名字（或保持原名），确保bindIp和/etc/hosts已按新域名更新 - 重启所有节点，再执行
rs.initiate()重新初始化
rs.initiate() 后新成员一直卡在 STARTUP2 怎么办
这说明成员已加入集群，但无法与主节点建立心跳连接。重点不是“初始化慢”，而是网络层阻断未解除：
- 检查主节点是否真在运行：
ps aux | grep mongod，确认它监听的是真实 IP（如192.168.10.11:27017），而非127.0.0.1:27017 - 在新成员上执行：
telnet 主节点IP 27017；失败则查防火墙、安全组、云平台白名单；成功则继续下一步 - 登录主节点，运行
rs.conf()，确认里面每个成员的host字段值（如"mongo1.example.com:27017"）能被主节点自己解析：getent hosts mongo1.example.com - 如果解析失败，不要改 DNS，立刻在主节点的
/etc/hosts中补上对应映射——副本集成员启动时会主动查自己 hostname，解析失败会导致心跳异常，即使其他节点能连它也不行
最易被忽略的一点：副本集配置一旦写入 local.system.replset，就不会随系统 hosts 或 DNS 变更而自动刷新；每次域名调整，都必须显式 reconfig 或重置表，没有中间路径。
