Spring容器报“找不到Bean”本质是启动时未注册或定位到目标组件，主因包括：未加@Component等注解、扫描路径未覆盖目标包、注入类型与候选Bean不匹配、条件注解不满足或泛型擦除，可通过DEBUG日志和getBeanNamesForType验证。
Spring 容器报“找不到 Bean”，本质是它在启动时没能注册或定位到你期望注入的那个组件。问题不总出在代码写错，更多时候是配置、扫描、条件或生命周期上的细微偏差。下面从最常踩的坑出发，给出可立即上手的排查路径。
确认 Bean 是否被 Spring 管理
这是第一步，也是最容易忽略的一步。
- 检查目标类是否加了 @Component、@Service、@Repository 或 @Controller 注解；接口不能加，必须加在实现类上
- 如果是第三方类（比如工具类、SDK 类），不能直接注解，得在配置类里用 @Bean 方法显式声明
- 确保类不是 new 出来的：反射调用、手动 new、工厂方法返回的对象，都不在 Spring 容器中，无法被注入或注入到别人身上
检查组件扫描是否覆盖目标包
Spring Boot 默认只扫描启动类所在包及其子包。如果你的 Bean 在其他包下，就会“隐身”。
- 查看启动类上的 @SpringBootApplication 是否隐含了扫描范围；若没有特别指定，就只能扫同级和子级
- 如果 Bean 在
com.example.infra，而启动类在com.example.app，那默认扫不到——需显式配置：@SpringBootApplication(scanBasePackages = {"com.example.app", "com.example.infra"}) - Maven 多模块项目中，注意模块是否被正确引入，IDE 是否刷新了依赖（尤其 IntelliJ 的 “Reload project”）
核对注入类型与候选 Bean 是否匹配
类型不一致、多个实现、条件不满足，都会让 Spring “视而不见”。
- 接口有多个实现类时，仅靠 @Autowired 会失败；必须配合 @Qualifier("beanName") 或 @Primary 指定唯一候选
- 检查是否误用了 @ConditionalOnMissingBean、@Profile("dev") 等条件注解——当前环境不满足条件，Bean 就不会注册
- 留意泛型擦除问题：比如注入
Map，但实际注册的是HashMap，类型不严格匹配也会失败
启用 DEBUG 日志快速定位加载过程
光看错误堆栈不够，要看 Spring 实际加载了哪些 Bean。
- 在
application.properties中添加：logging.level.org.springframework.beans.factory=DEBUG - 启动后搜索日志中的
Creating shared instance of singleton bean和Skipping bean definition，能清楚看到哪些类被注册、哪些被跳过、为什么跳过 - 配合
ApplicationContext.getBeanNamesForType(YourClass.class)在启动后主动查一遍容器里有没有这个类型，比猜更可靠
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
