在IntelliJ中通过Maven连接MongoDB时DNS查询失败求助

排查与解决建议 #

1. 强制MongoDB驱动使用系统DNS解析
   异常显示驱动依赖JndiDnsClient时出现DNS超时，可强制切换为系统默认DNS解析客户端，有两种实现方式：

   • 代码中配置MongoClient：

     import com.mongodb.client.MongoClients;
     import com.mongodb.client.MongoClient;
     import com.mongodb.MongoClientSettings;
     import com.mongodb.ConnectionString;
     import com.mongodb.internal.dns.DefaultDnsClient;
     
     public class MongoConnection {
         public static void main(String[] args) {
             ConnectionString connStr = new ConnectionString("你的MongoDB连接字符串");
             MongoClientSettings settings = MongoClientSettings.builder()
                 .applyConnectionString(connStr)
                 .dnsClient(DefaultDnsClient.create())
                 .build();
             MongoClient mongoClient = MongoClients.create(settings);
             // 后续数据库操作
         }
     }
     

   • 或在IntelliJ启动参数中添加VM选项：

     -Dmongodb.dns.client=com.mongodb.internal.dns.DefaultDnsClient
     

2. 调整JVM的DNS相关参数
   Java虚拟机有独立的DNS缓存和超时配置，可通过启动参数优化：

   • 禁用JVM DNS缓存（避免旧缓存干扰）：

     -Dnetworkaddress.cache.ttl=0 -Dsun.net.inetaddr.ttl=0
     

   • 调大DNS UDP请求超时与重试次数：

     -Dsun.net.dns.udp.timeout=5000 -Dsun.net.dns.udp.retries=5
     

   这些参数可在IntelliJ的Run/Debug Configurations对应启动项的VM options中添加。

3. 单独测试Java的DNS解析能力
   编写简单测试类，验证Java环境是否能正常解析目标域名：

   import java.net.InetAddress;
   
   public class DnsResolutionTest {
       public static void main(String[] args) {
           try {
               String targetHost = "<DBADDRESS>.mongodb.net";
               long startTime = System.currentTimeMillis();
               InetAddress[] addresses = InetAddress.getAllByName(targetHost);
               long endTime = System.currentTimeMillis();
   
               System.out.println("解析耗时：" + (endTime - startTime) + "ms");
               for (InetAddress addr : addresses) {
                   System.out.println("解析到地址：" + addr.getHostAddress());
               }
           } catch (Exception e) {
               e.printStackTrace();
           }
       }
   }
   

   若该类运行也超时，说明问题出在Java环境的DNS配置；若能正常解析，则可确认是驱动的JNDI解析逻辑问题。

4. 检查IntelliJ代理设置
   进入File > Settings > Appearance & Behavior > System Settings > HTTP Proxy，确认代理设置与系统一致（选择Use system proxy settings），或暂时关闭代理测试连接。部分场景下IntelliJ的独立代理会导致DNS请求未走VPN通道。

5. 排查本地安全软件拦截
   暂时关闭本地防火墙、杀毒软件等安全工具，测试是否能正常连接。部分安全软件可能拦截Java程序发起的UDP DNS请求，即使系统其他工具（如Mongo Compass）能正常访问。

需要补充的排查信息 #

• 本地运行Java程序的JDK版本（含厂商：OpenJDK/Oracle JDK等），以及与队友的JDK版本对比
• 项目中MongoDB Java驱动的具体版本（确认与队友是否一致）
• 上述DNS测试类的运行结果（是否解析成功、耗时、异常信息）
• IntelliJ的代理配置详情
• 本地安装的防火墙/安全软件类型

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