Spring依赖注入与组件扫描核心在于两步:先用@Component及其衍生注解标记类,再通过@ComponentScan指定路径启用扫描,最后由@Autowired在容器管理的Bean内完成类型匹配注入。

Java 注解配合 Spring 实现依赖注入与组件扫描,核心在于两步:让 Spring “看见”你的类(扫描),再让 Spring “安排好”它们之间的关系(注入)。关键不是加了注解就自动生效,而是整个容器上下文得搭对。
@Component 及衍生注解标记组件
@Component 是最基础的组件标记,表示这个类希望被 Spring 管理。@Service、@Repository、@Controller 是它的语义化变体,作用完全等效,仅用于分层标识和未来扩展。
- 加在类上即可,如 @Service public class OrderService { ... }
- 不指定 value 时,Spring 默认以类名首字母小写作为 Bean 名(orderService)
- 可显式指定名称:@Service("myOrderService"),后续可用该名称注入
- 注意:仅加注解没用——它只是个“标签”,不是“开关”
@ComponentScan 启动扫描机制
Spring 不会翻遍整个项目找 @Component,必须明确告诉它“去哪找”。这就是 @ComponentScan 的职责。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
- 通常加在启动类或配置类上:@ComponentScan(basePackages = "com.example.app")
- basePackages 必须覆盖目标组件所在包;若组件在 com.example.util,而扫描只写了 com.example.app,util 类会被忽略
- Spring Boot 默认只扫描启动类所在包及其子包,跨包需显式配置
- 多模块项目中,父模块的 @ComponentScan 不会扫描子模块字节码——子模块需独立配置或通过 starter 引入
@Autowired 完成依赖注入
@Autowired 告诉 Spring:“这个字段/构造器/方法,需要你填一个匹配的 Bean 进来”。但它只在 Spring 管理的 Bean 内部有效。
立即学习“Java免费学习笔记(深入)”;
- 推荐使用构造器注入:public UserService(UserDao userDao) { this.userDao = userDao; } —— 依赖明确、不可变、启动即校验
- 字段注入(@Autowired private UserDao userDao;)虽简洁,但字段可能为 null:比如你在 new UserService() 手动创建实例,Spring 完全不参与,注入自然失效
- 存在多个同类型 Bean 时,必须配合 @Qualifier("beanName") 或在候选 Bean 上加 @Primary
- 不能用于 static 成员——Spring 不处理静态字段或方法
常见失效原因与自查要点
注入失败报 NoSuchBeanDefinitionException,90% 不是写错了注解,而是环境没配齐。
- 检查启动类是否加了 @SpringBootApplication(它自带 @ComponentScan)或显式 @ComponentScan,且路径正确
- 确认目标类确实被编译进 classpath,IDE 编译输出目录与运行 classpath 是否一致(冷部署后未重启应用很常见)
- 查看类是否在 Spring 容器生命周期内被使用:比如在 @PostConstruct 方法里访问未完成注入的字段,尤其开启懒加载时容易出问题
- Lombok 的 @RequiredArgsConstructor 若生成构造器含未定义 Bean,会导致启动阶段直接失败,而非运行时报空指针

















