本地Spring Boot连接MongoDB失败：无法查询TXT记录问题排查

问题背景 #

本地Windows笔记本启动Spring Boot应用（无论是Eclipse运行、gradlew bootRun还是heroku local）时，抛出DNS相关异常：

Caused by: com.mongodb.MongoConfigurationException: Failed looking up TXT record for host cluster0.baqtr.mongodb.net
...
Caused by: java.io.UncheckedIOException: java.net.SocketException: Network is unreachable: connect

使用的MongoDB连接字符串为srv格式：

mongodb+srv://${MONGODB_USER_NAME}:${MONGODB_PASSWORD}@cluster0.baqtr.mongodb.net/[db name]?retryWrites=true&w=majority

• 应用部署在Heroku上时连接完全正常
• 本地用mongosh执行相同连接字符串能成功连接数据库
• 近期唯一特殊操作：曾安装过certbot，现已卸载

已做的排查信息 #

执行dig TXT cluster0.baqtr.mongodb.net的结果：

• Heroku实例：SERVER: 10.1.0.2#53(10.1.0.2) (UDP)
• 本地VirtualBox实例：SERVER: 10.1.0.2#53(10.1.0.2) (UDP)
• 本地Windows笔记本：SERVER: 8.8.8.8#53(8.8.8.8)

Windows WiFi网络已手动设置IPv4首选DNS为8.8.8.8、备用为8.8.4.4，但ipconfig输出显示：

Wireless LAN adapter Wi-Fi:
Connection-specific DNS Suffix  . : hsd1.ca.comcast.net

临时解决办法：在Eclipse运行配置中添加VM参数-Djava.naming.provider.url="dns://8.8.8.8"后，应用可正常连接。

核心疑问验证与分析 #

你的怀疑是正确的——Windows大概率没有真正应用你手动设置的DNS服务器，而是优先使用了Comcast（你的ISP）推送的DNS。

原因在于：MongoDB的srv连接字符串必须依赖DNS查询TXT和SRV记录来获取集群的节点列表信息，当系统实际使用的DNS无法解析这些特殊记录时，就会触发Failed looking up TXT record异常。而mongosh能正常连接，是因为它的DNS解析逻辑可能绕过了系统默认配置，或者自带了更灵活的解析策略，和JVM默认的解析逻辑不同。

永久解决方案 #

1. 强制Windows应用手动DNS设置 #

• 打开「网络和共享中心」→ 点击当前WiFi连接 → 「属性」→ 选中「Internet协议版本4 (TCP/IPv4)」→ 「属性」
• 确认勾选「使用下面的DNS服务器地址」，填入8.8.8.8（首选）和8.8.4.4（备用）
• 点击「高级」→ 切换到「DNS」标签页：
  • 删除所有自动获取的DNS服务器地址
  • 确保手动添加的8.8.8.8和8.8.4.4排在列表最顶部
  • 取消勾选「在DNS中注册此连接的地址」，防止ISP DNS覆盖设置
• 保存后执行ipconfig /flushdns刷新本地DNS缓存

2. 全局配置JVM DNS解析 #

如果Windows DNS设置始终被ISP覆盖，可以给JVM全局指定DNS服务器，避免每次运行都手动加VM参数：

• 系统环境变量中添加_JAVA_OPTIONS，值设为-Djava.naming.provider.url="dns://8.8.8.8"
• 或者修改项目根目录的gradle.properties，添加org.gradle.jvmargs=-Djava.naming.provider.url="dns://8.8.8.8"，这样gradlew bootRun会自动应用该参数

3. 改用非srv格式的连接字符串 #

MongoDB Atlas支持直接提供集群节点地址的连接字符串，无需依赖DNS查询TXT/SRV记录：

• 登录MongoDB Atlas控制台，进入目标集群→「连接」→「连接你的应用」
• 选择「驱动程序版本3.4或更早」，会生成非srv格式的连接字符串，示例：

  mongodb://${MONGODB_USER_NAME}:${MONGODB_PASSWORD}@cluster0-shard-00-00.baqtr.mongodb.net:27017,cluster0-shard-00-01.baqtr.mongodb.net:27017,cluster0-shard-00-02.baqtr.mongodb.net:27017/[db name]?ssl=true&replicaSet=atlas-xxxxxx-shard-0&authSource=admin&retryWrites=true&w=majority
  

• 使用该字符串可以绕过DNS解析环节，直接连接集群节点

验证方法 #

修改DNS设置后，执行以下命令验证：

nslookup cluster0.baqtr.mongodb.net

查看输出的服务器地址是否为8.8.8.8；再执行：

nslookup -type=TXT cluster0.baqtr.mongodb.net

确认能正常返回TXT记录，说明DNS设置生效。

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