Spring Boot依赖注入失败问题解析与解决方案

1. 问题背景与现象解析

在Spring Boot项目启动时遇到"Error creating bean with name 'XXXController': Injection of resource dependencies failed"这个错误，相信不少Java开发者都曾为此头疼过。这个报错直指Spring框架的核心机制——依赖注入(DI)失败，意味着Spring容器无法正确装配Controller所需的依赖项。

我最近在一个电商后台系统开发中就遇到了这个典型问题。项目采用Spring Boot 2.7 + MyBatis 3.5的组合，当启动应用时控制台直接抛出异常，整个应用启动失败。这种问题特别容易出现在团队协作开发中，当某个成员修改了基础配置但未及时同步时，就会导致其他成员的本地环境启动失败。

错误堆栈通常会显示类似这样的信息：

java复制org.springframework.beans.factory.BeanCreationException: 
Error creating bean with name 'userController': 
Injection of resource dependencies failed; 
nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: 
No qualifying bean of type 'com.example.service.UserService' available

2. 核心原因深度剖析

2.1 注解缺失问题

这是最常见的原因之一，Spring框架依赖注解来识别和管理Bean。Controller中需要注入的依赖如果没有被正确标注，就会导致注入失败。

典型场景1：Mapper接口缺少注解

java复制// 错误示例：缺少@Mapper注解
public interface UserMapper {
    User selectById(Long id);
}

// 正确示例
@Mapper // 关键注解
public interface UserMapper {
    User selectById(Long id);
}

或者没有在主启动类上配置Mapper扫描：

java复制@SpringBootApplication
@MapperScan("com.example.mapper") // 必须添加此注解
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

典型场景2：Service实现类未标注@Service

java复制// 错误示例：实现类缺少@Service
public class UserServiceImpl implements UserService {
    //...
}

// 正确示例
@Service // 关键注解
public class UserServiceImpl implements UserService {
    //...
}

提示：在团队协作中