@Lazy 注解使 Bean 延迟初始化,仅在首次使用时创建,适用于开销大、非必需启动即加载的场景,如外部服务客户端、依赖未就绪资源或解决循环依赖;可标注在类、@Bean 方法、注入点或全局配置上,但需注意代理机制与触发时机。

@Lazy 注解用于告诉 Spring 容器:这个 Bean 不要在应用启动时立即创建,而是等到第一次被实际使用(比如通过 ApplicationContext.getBean() 获取,或被其他 Bean 注入并首次调用)时才初始化。
什么时候需要 @Lazy
适用于初始化开销大、非必需在启动时就存在的 Bean,例如:
- 连接外部服务(如 Redis、Elasticsearch 客户端)但启动时并不立刻使用
- 依赖尚未就绪的资源(如数据库连接池刚初始化完成前)
- 避免循环依赖问题(配合 @Autowired 使用时,可让注入点变成代理,推迟目标 Bean 创建)
基本用法:标注在类或方法上
直接加在 @Component 类或 @Bean 方法上即可启用延迟加载:
@Component
@Lazy
public class HeavyService {
public HeavyService() {
System.out.println("HeavyService 实例化了");
}
}
或者在配置类中:
立即学习“Java免费学习笔记(深入)”;
@Configuration
public class AppConfig {
@Bean
@Lazy
public LightService lightService() {
return new LightService();
}
}
这样,Spring 启动时不会创建 HeavyService 或 lightService,直到某处真正调用它。
配合 @Autowired 使用的细节
如果一个 Bean A 依赖 Bean B,而你希望 B 延迟加载,只在 A 上加 @Lazy 没用,必须在注入点或 B 的定义上加:
- 方式一:在字段/构造器参数上加
@Lazy(推荐)
@Service
public class OrderService {
@Autowired
@Lazy // 关键:让注入的 UserService 是懒加载代理
private UserService userService;
public void process() {
userService.doSomething(); // 此时才真正创建 UserService 实例
}
}
- 方式二:在
UserService类上加@Lazy,且确保注入点没有被其他非懒 Bean 提前触发
注意:被 @Lazy 修饰的依赖,Spring 会注入一个 CGLIB 代理对象,首次调用方法时才触发真实 Bean 的创建和初始化。
全局开启延迟加载(慎用)
可在主类或配置类上加 @Lazy,使整个容器默认延迟加载:
@SpringBootApplication
@Lazy
public class App {
public static void main(String[] args) {
SpringApplication.run(App.class, args);
}
}
但这样可能导致部分基础 Bean(如 DataSource、TransactionManager)无法及时就位,引发运行时报错,不建议全局开启,按需使用更安全。
掌握好作用位置和触发时机,@Lazy 就能帮你优化启动速度、规避依赖顺序问题,用起来并不复杂但容易忽略细节。


















