RuoYi-Vue-Pro项目启动时MyBatis Mapper未找到问题解析

问题现象

在使用RuoYi-Vue-Pro项目时，开发者按照官方文档启动system系统服务和infra基础设施两个模块后，系统报出以下错误：

1. MyBatis警告：在指定包中未找到Mapper
2. Bean创建异常：无法注入deptApiImpl和deptServiceImpl的依赖
3. 最终抛出NoSuchBeanDefinitionException，表明DeptMapper类型的Bean不存在

问题原因分析

这个问题主要涉及Spring Boot应用启动时的Bean加载机制和MyBatis的Mapper扫描配置。从错误信息可以判断出：

1. Mapper扫描失败：MyBatis无法在指定包路径下扫描到Mapper接口，导致后续无法创建对应的Mapper Bean
2. 依赖注入失败：由于Mapper Bean未创建，依赖这些Mapper的Service层Bean也无法正常初始化
3. 组件扫描范围：可能是项目模块化结构导致Spring未正确扫描到Mapper接口所在的包

解决方案

经过验证，该问题可以通过以下步骤解决：

1. 执行Maven清理：在项目根目录下运行mvn clean命令，清除可能存在的构建缓存
2. 重新构建项目：执行mvn install确保所有模块正确编译
3. 检查依赖关系：确认system模块正确依赖了包含Mapper接口的模块
4. 验证配置：检查MyBatis的Mapper扫描路径是否包含Mapper接口所在包

深入理解

对于Spring Boot与MyBatis集成项目，这类问题的根本原因通常在于：

1. 组件扫描机制：Spring Boot默认只会扫描主类所在包及其子包，多模块项目需要特别注意
2. MyBatis配置：@MapperScan注解的basePackages属性需要正确设置，包含所有Mapper接口所在包
3. 模块依赖：在模块化项目中，包含Mapper的模块需要被其他模块正确依赖

最佳实践建议

为避免类似问题，建议开发者：

1. 在多模块项目中统一管理Mapper扫描路径
2. 使用明确的包命名规范，便于扫描配置
3. 在父POM中统一定义MyBatis相关依赖版本
4. 开发时注意观察启动日志中的组件扫描信息

通过理解Spring Boot的自动配置机制和MyBatis的集成原理，开发者可以更高效地解决这类启动时依赖注入问题。