Spring Boot依赖注入报错主因是Bean未被容器识别或依赖关系混乱：类未加@Component等注解、扫描路径不符、循环依赖、多实现类未指定@Qualifier/@Primary、作用域不匹配等，对应需补注解、调扫描、改注入方式、加限定符或调整作用域。
Spring Boot 中依赖注入报错，多数不是代码写错了，而是 Spring 容器没“看见”你要用的 Bean，或者它“理不清”依赖关系。下面几种最常遇到的情况，对应改法清晰直接。
类没被 Spring 管理（最常见）
报错典型提示：Consider defining a bean of type 'xxx' in your configuration 或 required a bean of type 'X' that could not be found。
本质是：你写的类（比如 UserService）只是普通 Java 类，Spring 根本没把它注册成 Bean。
- 确认加了对应注解：@Service（业务层）、@Repository（数据层）、@Controller / @RestController（Web 层）、@Component（通用）
- 检查类是否在 Spring Boot 主启动类的包或其子包下；如果不是，用
@ComponentScan(basePackages = {"com.example.xxx"})显式指定扫描路径 - 接口实现类要注解在实现类上，不是接口上。例如 UserService 接口不用加注解，UserServiceImpl 类必须加 @Service
循环依赖导致创建失败
报错典型提示：BeanCurrentlyInCreationException，常伴随 “circular reference” 字样。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
尤其在 Spring Boot 3.x（基于 Spring Framework 6）中，默认禁止循环依赖，构造器注入时几乎必报错。
- 优先把构造器注入改成字段注入或 Setter 注入（Spring 默认支持单例 Bean 的这种循环）
- 如果必须用构造器注入，给其中一个依赖加
@Lazy，例如：public UserService(@Lazy OrderService orderService) - 更彻底的解法：提取公共逻辑到新服务，或引入事件、回调等松耦合方式，从设计上打破闭环
接口有多个实现类，注入不明确
报错表现：启动时报错说“expected single matching bean but found X”，即找到多个候选 Bean。
比如 UserService 接口有两个实现类 UserServiceImplA 和 UserServiceImplB，而你只写了 @Autowired private UserService service;。
- 用
@Qualifier("beanName")指定具体 Bean 名，名称默认是类名首字母小写（如 userServiceImplA） - 或在某个实现类上加
@Primary，让 Spring 优先选它 - 也可以改用
@Resource(name = "xxx")，它是按名称匹配，更直观
作用域或生命周期不匹配
比如把 prototype（原型）作用域的 Bean 注入到 singleton（单例）Bean 中，可能导致状态混乱或注入时机异常。
- 避免将非单例 Bean 直接注入单例 Bean 的字段——可改用
ObjectProvider<x></x>或ApplicationContext.getBean(X.class)延迟获取 - 确认 @Scope 注解使用合理；若无特殊需要，保持默认 singleton 即可
- 懒加载场景可加
@Lazy，避免启动时就初始化所有依赖
