MongoDB驱动从3.0迁移至5.1.2时出现NoSuchMethodError问题求助

这个java.lang.NoSuchMethodError的核心原因是类加载冲突：Web环境中加载到了旧版本（3.x）的MongoDB驱动类，而非你部署的5.1.2版本。5.x版本的com.mongodb.MongoClient已经移除了(java.util.List, java.util.List, com.mongodb.MongoClientOptions)这个构造方法，改用MongoClientSettings构建实例，但报错栈显示你的代码仍在调用这个已被废弃移除的构造方法。

1. 更新MongoClient创建代码 #

检查GXCMongoDBConector.java:811处的代码，替换旧的构造方法调用为5.x版本的API：

// 替换旧的MongoClient实例化代码
MongoClient mongoClient = MongoClients.create(options);

确保所有创建MongoClient的逻辑都使用MongoClients.create()静态方法，而非直接调用MongoClient的旧构造。

2. 彻底清理旧驱动文件 #

• 检查Web容器（如Tomcat）的全局lib目录，删除所有3.x版本的MongoDB相关jar包（比如mongo-java-driver-3.x.x.jar）。
• 解压你的war包，查看WEB-INF/lib目录，确认没有遗留旧版本的Mongo驱动jar。若maven打包时存在依赖传递引入旧包，在pom.xml中添加排除规则：

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>5.1.2</version>
    <exclusions>
        <exclusion>
            <groupId>org.mongodb</groupId>
            <artifactId>mongo-java-driver</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 调整类加载优先级（若需要） #

部分Web容器会优先加载全局lib目录的jar包，而非war包内的依赖。如果你的容器支持，配置war包的类加载优先级高于全局lib，或者直接移除全局lib中的Mongo驱动，避免版本冲突。

4. 验证依赖一致性 #

执行mvn dependency:tree命令查看项目依赖树，确认所有MongoDB相关依赖均为5.1.2版本。若发现其他版本的依赖，手动通过<exclusion>标签排除。

5.x版本的MongoDB驱动已模块化，mongodb-driver-sync依赖已包含bson和mongodb-driver-core，你可以简化pom.xml的依赖配置，只保留核心依赖：

<dependency>
    <groupId>org.mongodb</groupId>
    <artifactId>mongodb-driver-sync</artifactId>
    <version>5.1.2</version>
</dependency>

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