MongoDB连接报错：java.lang.NoSuchMethodError问题求助

核心原因 #

这个报错的本质是MongoDB Java驱动版本冲突或不兼容：

• getDnsClient()是MongoDB驱动4.10及以上版本新增的API
• 若项目中同时引入了不同版本的MongoDB核心依赖（如mongodb-driver-core、mongodb-driver-sync等），类加载时就会出现找不到对应方法的情况

具体解决方案 #

1. 统一所有MongoDB依赖版本 #

确保项目内所有MongoDB相关依赖使用同一稳定版本（推荐4.10+，比如4.11.1、5.0.13），避免版本混杂。

Maven示例：

<dependencyManagement>
    <dependencies>
        <!-- 统一MongoDB驱动版本 -->
        <dependency>
            <groupId>org.mongodb</groupId>
            <artifactId>mongodb-driver-bom</artifactId>
            <version>4.11.1</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

<dependencies>
    <!-- 仅引入需要的驱动模块 -->
    <dependency>
        <groupId>org.mongodb</groupId>
        <artifactId>mongodb-driver-sync</artifactId>
    </dependency>
</dependencies>

Gradle示例：

implementation platform('org.mongodb:mongodb-driver-bom:4.11.1')
implementation 'org.mongodb:mongodb-driver-sync'

2. 清理冲突依赖 #

检查项目依赖树，移除重复或版本不一致的MongoDB依赖：

• Maven查看依赖树命令：

  mvn dependency:tree
  

• Gradle查看依赖树命令：

  gradle dependencies
  

找到所有org.mongodb开头的依赖，确保版本完全一致，排除旧版本的冲突依赖。

3. 可选：显式指定DNS客户端 #

若版本统一后仍有问题，可尝试显式指定默认DNS客户端（通常无需此操作，但可作为排查手段）：

public MongoDatabase connect() {
    try {
        String connectionString = "mongodb+srv://dev:<censored>@cluster0.ji1ynnc.mongodb.net/?retryWrites=true&w=majority&appName=AtlasApp";

        MongoClientSettings settings = MongoClientSettings.builder()
                .applyConnectionString(new ConnectionString(connectionString))
                .dnsClient(com.mongodb.spi.dns.DefaultDnsClient.create())
                .build();

        MongoClient mongoClient = MongoClients.create(settings);
        return mongoClient.getDatabase("dashboard");

    } catch (Exception e) {
        System.err.println(e);
        return null;
    }
}

关键注意事项 #

• 不要混合不同版本的MongoDB驱动模块，比如用4.9的mongodb-driver-core搭配4.11的mongodb-driver-sync
• 若使用Spring Boot等框架，需确保框架自带的MongoDB驱动版本与你指定的版本一致，或通过dependencyManagement强制统一版本

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