MongoDB连接报错queryTxt ESERVFAIL问题咨询与求解

错误本质 #

ESERVFAIL 是DNS服务失败错误，意味着你的Xubuntu系统无法解析MongoDB Atlas集群域名 cluster0.we5ri9d.mongodb.net，连接请求因DNS查询超时，几秒后抛出错误。

解决方案 #

• 更换公共DNS服务器
  Xubuntu默认DNS可能无法解析Atlas域名，手动配置公共DNS：

  1. 打开系统设置 → 网络 → 对应网络连接的设置 → IPv4 → DNS，添加 8.8.8.8 和 1.1.1.1
  2. 终端执行命令重启网络：

     sudo systemctl restart systemd-resolved
     

• 验证域名解析状态
  在终端运行以下命令，确认域名能否正常解析：

  nslookup cluster0.we5ri9d.mongodb.net
  

  如果返回集群的IP地址，说明DNS配置生效；若仍失败，需排查网络限制。

• 排查网络环境限制

  • 检查防火墙是否屏蔽了DNS查询或MongoDB的端口（默认27017），暂时关闭防火墙测试
  • 若使用代理/VPN，确认代理允许解析外部域名，或暂时关闭代理尝试连接
  • 部分校园网/企业网会限制外部云服务访问，可切换至个人热点测试

• 确认连接字符串正确性
  检查 process.env.MONGO_URI 是否为MongoDB Atlas控制台复制的完整连接字符串，确保替换了<username>、<password>，格式类似：

  mongodb+srv://your-username:your-password@cluster0.we5ri9d.mongodb.net/your-dbname?retryWrites=true&w=majority
  

内容的提问来源于stack exchange，提问作者mhmdfrhn