解决Java NoSuchMethodError：MyBatis-Plus依赖冲突实战

1. 问题背景与现象描述

最近在维护一个基于Tomcat的后端服务时，遇到了一个典型的Java运行时异常。当某个特定接口被调用时，系统抛出如下错误：

code复制Handler dispatch failed; nested exception is java.lang.NoSuchMethodError: com.dse.gcjs.jcxx.service.impl.AttDseWrpPrnmsrServiceImpl.count(Lcom/baomidou/mybatisplus/core/conditions/Wrapper;)J

这个错误信息表明，JVM在运行时无法找到AttDseWrpPrnmsrServiceImpl类中的count方法。特别值得注意的是，这个方法签名显示它接受一个MyBatis-Plus的Wrapper参数，并返回一个long类型值。

2. 错误分析与初步排查

2.1 NoSuchMethodError的本质

NoSuchMethodError是Java中一个经典的链接时错误（LinkageError），它发生在编译时存在的方法在运行时却找不到的情况。这种情况通常由以下几种原因导致：

1. 类路径冲突：不同版本的jar包中存在相同类但方法签名不一致
2. 编译与运行环境不一致：编译时使用的类版本与运行时不同
3. 依赖传递问题：Maven/Gradle依赖管理不当导致版本冲突

2.2 初步诊断步骤

根据错误信息，我首先确认了几个关键点：

1. 检查AttDseWrpPrnmsrServiceImpl类在源码中的定义，确认count方法确实存在
2. 确认该方法在编译后的class文件中存在（使用javap工具反编译验证）
3. 检查MyBatis-Plus的Wrapper接口版本是否匹配

3. 深入问题根源

3.1 MyBatis-Plus版本兼容性问题

通过分析错误堆栈，发现问题的核心在于MyBatis-Plus的Wrapper接口。不同版本的MyBatis-Plus中，这个接口的方法签名可能发生变化。具体到本例：

• 在MyBatis-Plus 3.3.2中，count方法的签名确实如错误所示
• 但在某些其他版本中，这个方法可能被重命名或参数类型有变化

3.2 依赖树分析

使用Maven的依赖树分析命令：

bash复制mvn dependency:tree -Dincludes=com.baomidou:mybatis-plus-core

发现项目中确实声明了MyBatis-Plus 3.3.2版本，但进一步检查发现：

1. 本地开发环境依赖树显示统一使用3.3.2
2. 服务器运行时环境理论上也应该使用3.3.2
3. 但实际运行时报错，说明运行时加载的可能是其他版本

4. 问题解决方案

4.1 根本原因定位

经过仔细