Spring Boot集成Axon extensions.mongo 4.3构建项目报NoSuchMethodError
异常根因
这是典型的类路径Mongo Java Driver版本不兼容导致的运行时方法缺失错误。axon-mongo 4.3内置的MongoFactory组件在初始化Mongo客户端时,会调用ConnectionPoolSettings.Builder#maxWaitQueueSize(int)方法构建连接池配置。但项目当前类路径加载的Mongo驱动版本过高(一般是Spring Boot自动引入的4.x系列版本),该版本中早已移除了上述方法,因此触发java.lang.NoSuchMethodError。
快速排查
执行mvn dependency:tree | grep mongodb,直接查看项目实际加载的Mongo驱动版本:
- 如果输出包含
org.mongodb:mongodb-driver:jar:4.x.x条目,即可确认是版本冲突问题
修复方案
方案一:降级Mongo驱动到与axon-mongo 4.3匹配的版本
直接在pom.xml中显式声明3.12.11版本的Mongo驱动,覆盖Spring Boot自动引入的高版本依赖:
<dependency> <groupId>org.mongodb</groupId> <artifactId>mongodb-driver</artifactId> <version>3.12.11</version> </dependency>
3.12.11是完全适配axon-mongo 4.3的稳定版本,完整保留了maxWaitQueueSize方法,不存在方法缺失问题。
方案二:升级axon-mongo版本适配现有高版本Mongo驱动
如果需要保留Spring Boot自带的4.x版本Mongo驱动,可将axon-mongo升级到适配4.x驱动的稳定版本,推荐4.6.2及以上:
<dependency> <groupId>org.axonframework.extensions.mongo</groupId> <artifactId>axon-mongo</artifactId> <version>4.6.2</version> </dependency>
升级时需保证axon-mongo版本与项目中Axon核心依赖的大版本对齐,避免引发其他类加载异常。
避坑提示
- 不要随意篡改Axon提供的
MongoFactory初始化逻辑,该类内部已封装了Axon事件存储、snapshot存储所需的完整客户端配置,自定义参数错误也可能导致Bean初始化失败 - 排查依赖冲突时,可执行
mvn dependency:tree -Dincludes=org.mongodb,定位所有传递引入Mongo驱动的上游依赖,排除重复的冲突版本
内容的提问来源于stack exchange,提问作者TOOLAI
相关产品推荐
相关产品推荐

