MyBatis-Plus在Spring Boot 3.4.0下的Mapper扫描问题解析

问题背景

在使用MyBatis-Plus 3.5.9与Spring Boot 3.4.0组合开发时，开发者遇到了一个特殊的运行时问题。当项目以可执行JAR包方式运行时，系统会尝试扫描依赖包中的mapper文件夹，而实际上这些依赖包并不包含该目录，导致程序抛出FileNotFoundException异常。

现象描述

在Spring Boot 3.4.0环境下，应用程序启动时会执行以下异常行为：

1. 首先正常扫描项目自身的mapper接口
2. 随后错误地尝试扫描依赖包中的mapper目录
3. 由于依赖包中不存在mapper目录，导致抛出文件未找到异常

值得注意的是，当使用Spring Boot 3.2.4版本时，这个问题不会出现，表明这是一个与Spring Boot版本相关的问题。

技术分析

从堆栈跟踪可以看出，问题发生在Spring框架的资源扫描阶段。具体来说，当ClassPathScanningCandidateComponentProvider尝试扫描候选组件时，由于Spring Boot 3.4.0使用的Spring Framework 6.2.0版本中存在资源路径处理的问题，导致扫描过程会错误地包含依赖包中的路径。

解决方案

针对这个问题，开发者可以采取以下几种解决方案：

1. 降级Spring Boot版本：暂时回退到3.2.4版本，这是最直接的临时解决方案。

2. 精确指定mapper扫描路径：在配置MyBatis-Plus时，明确指定只扫描项目自身的mapper路径，避免扫描依赖包。

3. 等待官方修复：Spring Framework 6.2.2版本已经修复了相关问题，可以等待对应的Spring Boot版本发布后升级。

最佳实践建议

为了避免类似问题，建议开发者在配置MyBatis-Plus时：

1. 始终明确指定mapper接口的扫描路径
2. 使用具体的包路径而非通配符
3. 在升级Spring Boot版本前，充分测试mapper扫描功能
4. 考虑使用@Mapper注解替代包扫描方式

总结

这个问题展示了框架版本兼容性的重要性，特别是在Spring Boot和MyBatis-Plus这样的流行框架组合中。开发者应当关注框架的更新日志，了解版本间的行为变化，并在升级前进行充分的测试验证。