如何解决MongoDB副本集成员名字无法解析的问题_在/etc/hosts中配置静态映射

老伟吖_9945

老伟吖_9945

2026-04-09

465人浏览

原创

应修改所有副本集节点的 /etc/hosts,将各成员主机名静态映射至其真实IP(非127.0.0.1),确保 hostname -f 输出与副本集配置一致,且 host $(hostname -f) 能正确解析出可路由的真实IP。

如何解决mongodb副本集成员名字无法解析的问题_在/etc/hosts中配置静态映射

副本集初始化失败提示 hostname not found 怎么办

根本原因是 MongoDB 副本集成员在 rs.initiate() 或 rs.add() 时使用的主机名(比如 mongo2.example.com)无法被当前节点 DNS 解析。不是配置错,是压根查不到——DNS 查询超时或返回 NXDOMAIN,MongoDB 就直接报错退出。

最直接有效的解法就是绕过 DNS,用 /etc/hosts 做静态映射。但注意:所有参与副本集的节点(包括你正在操作的这台)都必须能互相解析彼此的主机名,缺一不可。

  • 检查当前节点能否解析目标成员名:ping -c 1 mongo2.example.com 或 getent hosts mongo2.example.com
  • 确认副本集配置里写的主机名,和 hostname -f 输出、/etc/hosts 里写的完全一致(区分大小写、无多余空格)
  • 修改 /etc/hosts 后无需重启 mongod,但必须确保 systemd-resolved 或 nscd 没缓存旧记录(可临时停用或执行 nscd -i hosts)

/etc/hosts 里该写 IP 还是写 127.0.0.1

写 127.0.0.1 是常见错误。副本集成员之间必须走真实网络通信,不能全绑到本地回环。每个成员的主机名必须映射到它对外提供服务的真实 IP(比如网卡 eth0 的 IPv4 地址)。

例如节点 A 实际 IP 是 192.168.10.11,它的 /etc/hosts 应包含:

192.168.10.11 mongo1.example.com mongo1

节点 B(IP 192.168.10.12)的 /etc/hosts 必须也有一行:

192.168.10.11 mongo1.example.com mongo1
  • 别漏掉别名(如 mongo1),有些应用或脚本会用短名连接
  • IPv6 地址(如 fd00::1)要单独加一行,IPv4 和 IPv6 不互通
  • 避免混用域名和短名:如果副本集配置用的是 mongo1.example.com,就不要只在 hosts 里写 mongo1

为什么 rs.status() 显示成员状态是 STARTUP2 却一直卡住

典型表现是成员日志里反复出现 Failed to connect to xxx:27017: HostNotFound,但 rs.status() 看状态停在 STARTUP2 ——说明它已经加入集群,却连不上其他成员同步数据。

这时候光看当前节点的 /etc/hosts 不够,得逐个登录其他成员,用 telnet mongo1.example.com 27017 测试连通性。失败原因往往有三个:

  • 目标节点防火墙没放开 27017 端口(或绑定了 127.0.0.1 而非 0.0.0.0)
  • 目标节点的 /etc/hosts 缺少对「自己」的映射(mongod 启动时会查自己 hostname,解析失败会导致心跳异常)
  • 副本集配置中写了域名,但某个成员的 /etc/resolv.conf 里配了 search 域,导致实际解析成了 mongo1.example.com.internal 这种拼接结果

用 hostname 和 host 命令验证是否真生效

别只信 ping。MongoDB 内部用的是 libc 的 getaddrinfo(),行为和 host 更接近。验证步骤要闭环:

在每个节点上依次执行:

hostname -f

输出必须和副本集配置里的主机名完全一致;再执行:

host $(hostname -f)

应返回对应的真实 IP,且这个 IP 能被其他节点路由到达。如果 host 返回 connection timed out,说明系统级解析已失效,/etc/hosts 没起作用或者格式有隐藏空格。

真正容易被忽略的是:容器环境或 systemd 服务里,mongod 可能运行在独立 network namespace 中,/etc/hosts 修改对它无效——这时得用 --add-host 参数或挂载 hosts 文件。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

895

5

mongodb启动命令
mongodb启动命令

MongoDB 是一种开源的、基于文档的 NoSQL 数据库管理系统。本专题提供mongodb启动命令的文章,希望可以帮到大家。

2023.08.08

3294

5

MongoDB删除数据的方法
MongoDB删除数据的方法

MongoDB删除数据的方法有删除集合中的文档、删除整个集合、删除数据库和删除指定字段等。本专题为大家提供MongoDB相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.19

3144

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

4849

19

mongodb有哪些应用领域
mongodb有哪些应用领域

mongodb 的应用领域涵盖广泛,包括内容管理系统、社交媒体、分析、移动应用、物联网、金融科技、医疗保健和广告技术等领域,因其灵活性、可扩展性和易用性而广受欢迎。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

978

6

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

8452

6

mongodb安装失败如何彻底删除
mongodb安装失败如何彻底删除

彻底删除 mongodb 安装失败的步骤:1、停止和禁用 mongodb 服务;2、删除配置文件、数据目录和日志文件;3、删除 mongodb 二进制文件;4、卸载 mongodb 套件(如果通过软件包管理器安装);5、删除 mongodb 用户、组和目录;6、重启系统。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

595

6

mongodb与mysql好用推荐
mongodb与mysql好用推荐

mongodb 适用于非结构化数据、高扩展性和灵活查询(如网站内容管理、社交媒体),而 mysql 适用于结构化数据、强数据一致性和联接查询(如电子商务、银行系统)。

2024.04.02

2549

9

mongodb数据库的优势有哪些
mongodb数据库的优势有哪些

mongodb 数据库以其灵活、可扩展和高性能而闻名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.08

2871

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习