1. 报错现象与背景分析
"Error creating bean with name 'xxxxxxxController': Injection of resource dependencies failed"这个报错是Spring Boot项目中典型的依赖注入失败问题。当Spring容器尝试创建Controller bean时，发现无法完成对其中某个资源的注入（通常是@Service或@Repository注解的组件），导致整个应用启动失败。
这个错误的核心在于Spring的依赖注入机制（DI）遇到了障碍。我最近在一个电商后台系统中就遇到了完全相同的报错，当时控制台打印的完整错误信息是：
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'productController': Injection of resource dependencies failed; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.example.service.ProductService' available从错误堆栈可以清晰看出：Spring在创建productController时，发现需要注入一个ProductService，但在容器中找不到符合条件的bean。这种情况在整合Spring Boot和MyBatis的项目中尤为常见，特别是在Controller-Service-Dao的分层架构中。
2. 常见原因深度排查
2.1 组件扫描范围问题
Spring Boot默认只会扫描主类所在包及其子包下的组件。如果你的Controller和Service不在同一个包或其子包下，Spring将无法自动发现并注册这些bean。
典型场景示例：
com.example ├── Application.java // 主类 ├── controller │ └── ProductController.java └── service └── ProductService.java如果主类在com.example包，而Service类被意外放在了com.otherpackage.service下，就会导致扫描不到的情况。我建议使用以下两种方式之一解决：
- 确保所有组件都在主类所在包或其子包下
- 显式添加@ComponentScan注解指定扫描路径：
@SpringBootApplication @ComponentScan({"com.example", "com.otherpackage"}) public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }2.2 注解缺失或错误
在Spring+MyBatis整合项目中，常见的注解问题包括：
- Service层：忘记添加@Service注解
- Mapper接口：
- 忘记添加@Mapper注解
- 或未在启动类添加@MapperScan指定扫描路径
- Controller层：错误使用了@Component而非@Controller
对于MyBatis特别需要注意的是：如果你使用的是XML映射文件方式，还需要确保：
- XML文件放在了resources下正确的目录（通常为mapper/）
- application.properties中配置了mybatis.mapper-locations
2.3 循环依赖问题
当两个bean互相依赖时，Spring可能无法完成依赖注入。例如：
@Service public class ServiceA { @Autowired private ServiceB serviceB; } @Service public class ServiceB { @Autowired private ServiceA serviceA; }这种情况Spring会抛出BeanCurrentlyInCreationException。解决方案包括：
- 重构代码消除循环依赖
- 使用@Lazy延迟加载其中一个bean
- 改用setter注入而非字段注入
2.4 多数据源配置问题
在配置多数据源时，如果没有正确指定每个Mapper接口对应的SqlSessionTemplate，会导致注入失败。例如：
@Mapper public interface UserMapper { //... }如果配置了多个数据源但未指定UserMapper使用哪个，就会报错。解决方案是在配置类中明确指定：
@Bean public SqlSessionTemplate sqlSessionTemplate1(@Qualifier("dataSource1") DataSource dataSource) { //... } @Bean public MapperScannerConfigurer mapperScannerConfigurer1() { MapperScannerConfigurer configurer = new MapperScannerConfigurer(); configurer.setBasePackage("com.example.mapper1"); configurer.setSqlSessionTemplateBeanName("sqlSessionTemplate1"); return configurer; }3. 系统化解决方案
3.1 检查Spring Boot启动日志
启动时添加--debug参数可以查看更详细的bean注册信息：
java -jar your-application.jar --debug在日志中搜索以下关键信息：
- "Creating shared instance of singleton bean" - 成功创建的bean
- "Skipping bean creation" - 被跳过的bean
- "No qualifying bean" - 找不到bean的错误
3.2 使用Bean验证工具
在Application类中添加以下代码可以主动检查bean是否被正确注册：
public static void main(String[] args) { ConfigurableApplicationContext context = SpringApplication.run(Application.class, args); // 检查特定bean是否存在 try { ProductService productService = context.getBean(ProductService.class); System.out.println("ProductService bean exists!"); } catch (NoSuchBeanDefinitionException e) { System.err.println("ProductService bean is missing!"); } // 打印所有已注册的bean名称 System.out.println("All registered beans:"); Arrays.stream(context.getBeanDefinitionNames()) .sorted() .forEach(System.out::println); }3.3 MyBatis特定检查清单
对于Spring Boot + MyBatis项目，建议按以下顺序检查：
- 确认Mapper接口有@Mapper注解或@MapperScan扫描
- 检查application.properties中的mybatis配置：
mybatis.mapper-locations=classpath:mapper/*.xml mybatis.type-aliases-package=com.example.model - 确认XML映射文件路径正确
- 检查SQLSessionFactory配置（如果是自定义配置）
3.4 依赖冲突排查
有时不同版本的依赖会导致bean注册失败。使用以下命令查看依赖树：
mvn dependency:tree重点关注：
- spring-boot-starter-web
- mybatis-spring-boot-starter
- spring-context
确保它们的版本兼容。Spring Boot官方推荐的版本组合可以在start.spring.io上查询。
4. 高级场景与解决方案
4.1 条件化Bean注册问题
当使用@Conditional系列注解时，可能因为条件不满足导致bean未被注册。例如：
@Bean @ConditionalOnProperty(name = "feature.enabled", havingValue = "true") public FeatureService featureService() { return new FeatureServiceImpl(); }如果application.properties中没有feature.enabled=true，这个bean就不会被注册。解决方案：
- 检查条件注解的配置
- 使用@ConditionalOnMissingBean等注解时要特别注意执行顺序
4.2 动态代理问题
当使用AOP或@Transactional时，Spring会创建代理对象。如果代理创建失败，也会导致依赖注入失败。常见情况包括：
- 类被final修饰，无法被CGLIB代理
- 方法被private修饰，无法被代理
- 同一个类内部方法调用不会经过代理
解决方案：
- 确保被代理的类和方法符合要求
- 使用接口+JDK动态代理方式
- 通过ApplicationContext获取代理对象：
@Service public class OrderService { @Autowired private ApplicationContext context; public void process() { // 获取代理对象 OrderService proxy = context.getBean(OrderService.class); proxy.internalMethod(); // 会经过代理 } @Transactional public void internalMethod() { // ... } }4.3 多模块项目中的组件扫描
在多模块项目中，常见的扫描问题包括：
- 主类所在的模块没有依赖包含组件的模块
- 组件所在的模块没有正确导出包
- @ComponentScan注解路径配置错误
解决方案示例（Maven多模块项目）：
parent ├── api (包含Controller) ├── service (包含Service) └── application (主模块)在application模块的pom.xml中：
<dependencies> <dependency> <groupId>com.example</groupId> <artifactId>api</artifactId> <version>${project.version}</version> </dependency> <dependency> <groupId>com.example</groupId> <artifactId>service</artifactId> <version>${project.version}</version> </dependency> </dependencies>在主类上添加：
@SpringBootApplication @ComponentScan({"com.example.api", "com.example.service"}) public class Application { // ... }5. 实战案例与经验分享
5.1 案例一：MyBatis Mapper未被扫描
现象：项目启动时报错找不到UserMapper的bean。
排查过程：
- 检查UserMapper接口有@Mapper注解
- 检查启动类有@MapperScan("com.example.mapper")
- 检查application.properties配置了mybatis.mapper-locations
- 最后发现是pom.xml中mybatis-spring-boot-starter版本与Spring Boot不兼容
解决方案：
<!-- 原配置 --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>1.3.1</version> </dependency> <!-- 修改为与Spring Boot 2.5.x兼容的版本 --> <dependency> <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>2.2.0</version> </dependency>5.2 案例二：多数据源配置错误
现象：系统需要连接两个数据库，配置后报错找不到bean。
错误配置：
@Configuration public class DataSourceConfig { @Bean @Primary public DataSource primaryDataSource() { // 配置第一个数据源 } @Bean public DataSource secondaryDataSource() { // 配置第二个数据源 } // 缺少针对第二个数据源的SqlSessionFactory配置 }正确配置：
@Configuration @MapperScan(basePackages = "com.example.mapper.primary", sqlSessionFactoryRef = "primarySqlSessionFactory") public class PrimaryDataSourceConfig { // 主数据源配置 } @Configuration @MapperScan(basePackages = "com.example.mapper.secondary", sqlSessionFactoryRef = "secondarySqlSessionFactory") public class SecondaryDataSourceConfig { // 次数据源配置 }5.3 个人经验总结
组件扫描黄金法则：保持项目结构清晰，所有组件放在主类所在包或其子包下。如果需要跨模块扫描，显式配置@ComponentScan。
MyBatis集成检查清单：
- 确认Mapper接口有@Mapper或@MapperScan
- 检查XML映射文件路径正确
- 验证mybatis.mapper-locations配置
- 确保依赖版本兼容
排错技巧：
- 使用--debug参数查看详细启动日志
- 在启动时打印所有注册的bean名称
- 对复杂项目，分模块逐步验证bean注册情况
避免的坑：
- 不要在配置类中使用@Autowired注入bean（可能导致循环依赖）
- 谨慎使用@PostConstruct，其中的依赖可能还未完全初始化
- 多数据源项目要为每个Mapper明确指定SqlSessionTemplate
工具推荐：
- Spring Boot Actuator的/beans端点可以查看所有注册的bean
- IDE的Diagrams功能可以可视化bean依赖关系
- mvn dependency:tree分析依赖冲突
