MongoDB副本集无法识别新增成员？检查网络连通性与端口放行

进行一次系统性的故障排查：当新加入的节点在 rs.status() 输出中持续显示 "stateStr": "DOWN" 或 "health": 0 时，几乎可以确定是网络层存在阻挡，而非配置语法错误或服务未启动。

验证节点间27017端口连通性

不要只依赖 ping 或仅测试本机。关键在于从“新增成员”所在机器向“主节点”的 IP 和端口发起连接测试，然后反向再执行一次：

• telnet 192.168.86.11 27017（从新节点连接主节点）
• nc -zv 192.168.86.11 27017（Linux 下更精确，无需依赖 telnet 包）
• 若连接失败，先临时关闭防火墙测试：sudo ufw disable（Ubuntu）或 sudo systemctl stop firewalld（CentOS）
• 在云服务器中，仅靠本地防火墙放开还不够——安全组若未放行，同样无法连通

确认bindIp配置是否允许跨节点访问

新增成员的 /etc/mongod.conf 中 net.bindIp 若仍为默认的 127.0.0.1，则仅能响应本机请求，其他节点发送的握手包会被内核直接丢弃：

• 正确做法是显式列出通信 IP：bindIp: 192.168.86.12,127.0.0.1（假设该节点内网 IP 为 192.168.86.12）
• 写 0.0.0.0 虽然可通，但不推荐用于生产环境，需配合防火墙严格限制来源 IP
• 修改后必须重启服务：systemctl restart mongod，使用 reload 无效

验证/etc/hosts是否完成双向静态映射

若副本集配置中使用主机名（例如 mongo2.example.com），而新增成员无法解析该名称，则 rs.add() 或心跳会卡在 STARTUP2 并报 HostNotFound：

• 在新增成员上执行 getent hosts mongo2.example.com，应返回真实内网 IP，而非 127.0.0.1
• 所有节点的 /etc/hosts 都必须包含彼此的映射，例如：192.168.86.11 mongo1.example.com mongo1
• 特别注意：新增成员自身的 hostname -f 输出必须与 rs.conf() 中声明的 host 字段完全一致，大小写及空格均不可有差异

校验keyFile与replSetName是否完全一致

即便网络连通，新增成员也可能因身份校验失败而被拒绝加入：

• 所有成员的 replication.replSetName 必须完全相同（大小写敏感），且与 rs.initiate() 中的 _id 一致
• 启用访问控制时，security.keyFile 文件内容必须字节级一致，权限必须为 600
• 通过日志确认：tail -f /var/log/mongodb/mongod.log | grep -i "key|repl|auth"，常见报错为 Unable to load key file: Invalid argument

真正导致故障的往往不是单一因素，而是多个条件叠加：例如 bindIp 未放开、/etc/hosts 缺少一行映射、安全组未配置等。建议每次仅修改一项，修改后立即通过 telnet 和 rs.status() 验证，这样比一次性调整多个配置更为可靠。