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下，就会导致扫描不到的情况。我建议使用以下两种方式之一解决：

1. 确保所有组件都在主类所在包或其子包下
2. 显式添加@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整合项目中，常见的注解问题包括：

1. Service层：忘记添加@Service注解
2. Mapper接口：
   • 忘记添加@Mapper注解
   • 或未在启动类添加@MapperScan指定扫描路径
3. 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。解决方案包括：

1. 重构代码消除循环依赖
2. 使用@Lazy延迟加载其中一个bean
3. 改用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项目，建议按以下顺序检查：

1. 确认Mapper接口有@Mapper注解或@MapperScan扫描
2. 检查application.properties中的mybatis配置：

   mybatis.mapper-locations=classpath:mapper/*.xml mybatis.type-aliases-package=com.example.model

3. 确认XML映射文件路径正确
4. 检查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就不会被注册。解决方案：

1. 检查条件注解的配置
2. 使用@ConditionalOnMissingBean等注解时要特别注意执行顺序

4.2 动态代理问题

当使用AOP或@Transactional时，Spring会创建代理对象。如果代理创建失败，也会导致依赖注入失败。常见情况包括：

1. 类被final修饰，无法被CGLIB代理
2. 方法被private修饰，无法被代理
3. 同一个类内部方法调用不会经过代理

解决方案：

• 确保被代理的类和方法符合要求
• 使用接口+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 多模块项目中的组件扫描

在多模块项目中，常见的扫描问题包括：

1. 主类所在的模块没有依赖包含组件的模块
2. 组件所在的模块没有正确导出包
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。

排查过程：

1. 检查UserMapper接口有@Mapper注解
2. 检查启动类有@MapperScan("com.example.mapper")
3. 检查application.properties配置了mybatis.mapper-locations
4. 最后发现是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 个人经验总结

1. 组件扫描黄金法则：保持项目结构清晰，所有组件放在主类所在包或其子包下。如果需要跨模块扫描，显式配置@ComponentScan。

2. MyBatis集成检查清单：

   • 确认Mapper接口有@Mapper或@MapperScan
   • 检查XML映射文件路径正确
   • 验证mybatis.mapper-locations配置
   • 确保依赖版本兼容

3. 排错技巧：

   • 使用--debug参数查看详细启动日志
   • 在启动时打印所有注册的bean名称
   • 对复杂项目，分模块逐步验证bean注册情况

4. 避免的坑：

   • 不要在配置类中使用@Autowired注入bean（可能导致循环依赖）
   • 谨慎使用@PostConstruct，其中的依赖可能还未完全初始化
   • 多数据源项目要为每个Mapper明确指定SqlSessionTemplate

5. 工具推荐：

   • Spring Boot Actuator的/beans端点可以查看所有注册的bean
   • IDE的Diagrams功能可以可视化bean依赖关系
   • mvn dependency:tree分析依赖冲突