MongoDB副本集默认不监听IPv6，必须显式配置bindIp包含::1或::并启用net.ipv6: true；rs.initiate()/rs.add()中IPv6地址须用方括号包裹，且需确保/etc/hosts或DNS正确解析。
MongoDB 副本集默认不监听 IPv6，即使系统已启用 IPv6，mongod 也不会自动绑定 ::1 或 ::，必须显式配置 bindIp 并确保 net.ipv6: true 生效——否则副本集成员间用 IPv6 地址初始化会失败，报错 Failed to connect to [::1]:27017: Connection refused 或初始化超时。
bindIp 必须显式包含 IPv6 地址，不能只靠 --ipv6 参数
很多人误以为加了 --ipv6 启动参数或配置 net.ipv6: true 就够了，其实不够。MongoDB 的 bindIp 是白名单机制，它只监听你写进去的地址，哪怕启用了 IPv6 支持，若 bindIp 里没列 ::1 或 ::，mongod 根本不会在 IPv6 socket 上 listen。
-
bindIp: "127.0.0.1"→ 只监听 IPv4，IPv6 连接被拒绝 -
bindIp: "::1"→ 只监听 IPv6 回环，IPv4 连接被拒绝 -
bindIp: "::1,127.0.0.1"→ 正确：双栈回环（推荐开发/测试） -
bindIp: "::,0.0.0.0"→ 允许所有 IPv6 和 IPv4 地址（生产慎用，需配防火墙+认证）
注意：bindIp 中的 IPv6 地址必须用引号包裹，否则 YAML 解析会把 ::1 当成 null；多个地址用英文逗号分隔，**不能有空格**。
副本集初始化时必须用方括号包裹 IPv6 地址
在 rs.initiate() 或 rs.add() 中，如果成员地址是 IPv6，URI 必须用方括号 [] 包裹，否则解析失败。这是 MongoDB URI 规范强制要求，和 HTTP 的 http://[::1]:27017 一致。
- 错误写法：
rs.add("::1:27017")→ 报错Invalid host format - 正确写法：
rs.add("[::1]:27017") - 带域名也一样：
rs.add("[mongodb-node-1.example.com]:27017")（前提是 DNS 解析出 IPv6 AAAA 记录）
如果你用配置文件启动副本集，replSet 配置里的 members[n].host 字段同样要写成 [::1]:27017，否则 mongod 启动时校验失败，直接退出并打印 Invalid replica set configuration: host must be of form host:port。
IPv6 下的 hostname 解析和 /etc/hosts 配置很关键
副本集依赖成员间能互相反向解析 hostname。IPv6 环境下，getaddrinfo() 默认优先查 AAAA，但很多系统没配好 IPv6 reverse DNS，导致 mongod 启动卡在 “waiting for replica set members to become reachable”。
- 检查每个节点能否
ping6通其他节点的 IPv6 地址 - 确认
/etc/hosts中 IPv6 条目格式正确，例如：fe80::1234:5678:9abc:def0 mongodb-node-1（链路本地地址慎用） - 避免使用
fe80::/10（链路本地）作为副本集成员地址，它无法跨子网路由；优先用唯一本地地址（fc00::/7）或全局单播（2000::/3） - 如果用 DNS，确保
nslookup -type=AAAA mongodb-node-1返回有效 IPv6 地址，且nslookup -type=PTR <reverse-addr>能正确返回主机名
一个容易被忽略的点：MongoDB 6.0+ 对 hostname 验证更严格，如果某成员只配置了 IPv4 地址而其他成员用 IPv6，整个副本集可能无法完成初始同步，因为 oplog fetcher 会因地址族不匹配失败。
真正麻烦的不是配置本身，而是 IPv6 和 hostname 解析混在一起时的调试链条太长：bindIp 写错 → listen 失败 → rs.add() 超时 → 你以为是网络问题 → 其实只是少了一对方括号或一行 /etc/hosts。建议先用 ss -tlnp | grep :27017 确认 socket 真的绑定了 tcp6，再查日志里有没有 Bound to ::1:27017 这行输出，最后才碰 rs.status()。
