ConfigServletWebServerApplicationContext : Exception encountered during context initialization - cancelling refresh attempt: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'categoryController': Unsatisfied dependency expressed through field 'categoryService'; nested exception is org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'categoryServiceImpl': Unsatisfied dependency expressed through field 'categoryMapper'; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type 'com.web.xiaomi.mapper.CategoryMapper' available: expected at least 1 bean which qualifies as autowire candidate. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}

### 解决 Spring Boot 中 `UnsatisfiedDependencyException` 的方法 当遇到 `org.springframework.beans.factory.UnsatisfiedDependencyException` 时，通常是因为某些 Bean 定义缺失或配置不当引起的。以下是针对 `CategoryController` 和其依赖项 `CategoryMapper` 报错的具体分析和解决方案。 #### 1. **检查 Controller 类中的依赖注入** 如果 `CategoryController` 使用了 `@Autowired` 注解来注入 `CategoryMapper` 或其他服务类，则需要确认这些被注入的对象是否已被正确声明为 Spring 管理的 Bean。例如： ```java @RestController @RequestMapping("/category") public class CategoryController { @Autowired private CategoryMapper categoryMapper; public List<Category> getAllCategories() { return categoryMapper.getAllCategories(); } } ``` 上述代码中，`CategoryMapper` 需要通过某种方式注册到 Spring 容器中[^1]。 --- #### 2. **确保 Mapper 接口已正确定义并扫描** 对于 MyBatis 的 Mapper 接口，需满足以下条件才能正常工作： - 添加 `@MapperScan` 注解到主应用类上，指定 Mapper 所在包路径。 ```java @SpringBootApplication @MapperScan("com.example.mapper") // 替换为实际的 Mapper 路径 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } } ``` 如果没有显式定义 `@MapperScan`，也可以单独给每个 Mapper 接口加上 `@Mapper` 注解[^4]。 --- #### 3. **验证 Service 层是否存在遗漏标注** 假设 `CategoryMapper` 是由某个 Service 进一步调用的，则该 Service 类也需要标记为 Spring 组件（如 `@Service`）。例如： ```java @Service public class CategoryService { @Autowired private CategoryMapper categoryMapper; public List<Category> fetchAllCategories() { return categoryMapper.getAllCategories(); } } ``` 如果缺少 `@Service` 或者未将其纳入组件扫描范围，可能导致 `NoQualifyingBeanDefinitionException`[^2]。 --- #### 4. **排查 Configuration 文件设置** MyBatis 的相关配置应写入 `application.properties` 或 `application.yml` 文件中。例如，在 properties 文件里可以这样配置数据源以及映射文件的位置： ```properties mybatis.mapper-locations=classpath:mapper/*.xml spring.datasource.url=jdbc:mysql://localhost:3306/yourdb?useSSL=false&serverTimezone=UTC spring.datasource.username=root spring.datasource.password=password spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver ``` 注意：如果 XML 映射文件路径不对，可能会间接影响 Mapper 的加载过程。 --- #### 5. **处理可能存在的 Jar 包冲突** 有时第三方库版本不兼容也会引发此类异常。建议清理 Maven 缓存后重新构建项目，并查看是否有重复引入相同功能的不同版本 jar 包。命令如下所示： ```bash mvn clean install -U ``` 此外可通过工具插件检测潜在冲突情况，比如使用 Dependency Convergence 插件。 --- #### 6. **调试技巧与日志定位** 启用详细的 DEBUG 日志可以帮助快速找到问题根源。修改 logback.xml 或 logging.level 设置以增加输出级别： ```yaml logging: level: com.example.category: DEBUG org.mybatis.spring: DEBUG ``` 观察控制台打印信息，特别是关于 Bean 初始化阶段的日志条目[^3]。 --- ### 总结 综上所述，解决 `UnsatisfiedDependencyException` 关键在于以下几个方面： - 正确配置 Component Scanning； - 对于特定框架（如 MyBatis），补充必要的注解支持； - 检查资源配置无误； - 排除外部依赖干扰因素；最后借助日志辅助诊断具体环节失误之处。