当前位置：首页 > news >正文

Spring Boot 中的 @Lazy 注解：延迟加载的深入解析与实践

news 2026/7/25 19:16:59

1. 引言

在 Spring Boot 应用中，Bean 的创建和依赖注入通常是在应用启动时完成的。这种默认的急切加载（Eager Loading）模式确保了所有 Bean 在需要时都已准备就绪，但有时也会带来不必要的启动开销，特别是对于那些初始化成本高、使用频率低的 Bean。

Spring 框架提供了@Lazy注解来解决这一问题。通过@Lazy，我们可以将 Bean 的创建推迟到第一次真正被请求时，从而优化应用的启动性能。本文将深入解析@Lazy注解的工作原理、使用场景、配置方式以及需要注意的陷阱。

2. @Lazy 注解的核心概念

2.1 什么是延迟加载？

延迟加载（Lazy Loading）是一种设计模式，其核心思想是“按需创建”。在 Spring 上下文中，它意味着一个被标记为@Lazy的 Bean，其初始化过程（调用构造方法、执行@PostConstruct方法、注入依赖等）不会在 Spring 容器启动时立即执行，而是会延迟到该 Bean 第一次被其他组件请求（例如通过@Autowired注入或ApplicationContext.getBean()调用）时才触发。

2.2 @Lazy 与默认急切加载的对比

特性	急切加载 (默认)	延迟加载 (@Lazy)
初始化时机	Spring 容器启动时	第一次被请求时
启动性能	可能较慢（所有 Bean 都初始化）	通常更快（只初始化必需的 Bean）
内存占用	启动后即占用	使用时才占用
适用场景	大多数核心、高频使用的 Bean	初始化成本高、使用不确定或低频的 Bean
潜在问题	启动时间长	首次请求时有延迟，循环依赖需配合`@Lazy`解决

3. @Lazy 的使用方式

3.1 在 Bean 定义上使用

最直接的方式是在@Component,@Service,@Repository,@Configuration等注解的类上添加@Lazy。

import org.springframework.context.annotation.Lazy; import org.springframework.stereotype.Service; @Service @Lazy // 这个 Service 将被延迟初始化 public class HeavyInitializationService { public HeavyInitializationService() { // 模拟耗时的初始化操作 System.out.println("HeavyInitializationService 构造函数被调用，初始化成本很高..."); try { Thread.sleep(3000); } catch (InterruptedException e) { e.printStackTrace(); } } public void doSomething() { System.out.println("HeavyInitializationService 正在工作..."); } }

3.2 在配置类中与 @Bean 一起使用

在 Java 配置类中，你可以将@Lazy注解与@Bean方法结合使用。

import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Lazy; @Configuration public class AppConfig { @Bean @Lazy // 这个 Bean 将被延迟初始化 public ExpensiveDataSource expensiveDataSource() { System.out.println("正在创建昂贵的 DataSource..."); // 模拟创建连接池等耗时操作 return new ExpensiveDataSource(); } }

3.3 在注入点使用

你还可以在依赖注入点（如字段、构造方法参数、Setter 方法参数）上使用@Lazy。这只会延迟该特定依赖的注入，而不是延迟目标 Bean 本身的初始化（如果目标 Bean 在其他地方被急切请求，它仍会提前初始化）。

import org.springframework.beans.factory.annotation.Autowired; import org.springframework.context.annotation.Lazy; @Service public class MyService { // 延迟注入这个依赖 @Autowired @Lazy private HeavyInitializationService heavyService; public void execute() { // 第一次调用 heavyService 的方法时，才会触发其初始化 heavyService.doSomething(); } }

4. 解决循环依赖

@Lazy是解决 Spring 中某些类型循环依赖问题的经典方法。其原理是打破初始化时的依赖环。

@Service public class ServiceA { private final ServiceB serviceB; // 在构造参数上使用 @Lazy，Spring 会注入一个代理对象 public ServiceA(@Lazy ServiceB serviceB) { this.serviceB = serviceB; } } @Service public class ServiceB { private final ServiceA serviceA; public ServiceB(ServiceA serviceA) { this.serviceA = serviceA; } }

在上面的例子中，ServiceA依赖于ServiceB，而ServiceB又依赖于ServiceA。通过在ServiceA的构造参数上添加@Lazy，Spring 在初始化ServiceA时，不会立即去初始化一个完整的ServiceBBean，而是先注入一个ServiceB的代理（Proxy）。当ServiceA后续真正调用serviceB的方法时，代理才会触发ServiceB的实际初始化。此时ServiceA已经初始化完成，ServiceB可以成功注入它，从而解决了循环依赖。

5. 注意事项与最佳实践

不要滥用：对于绝大多数简单、核心的 Bean，使用默认的急切加载即可。滥用@Lazy会使依赖关系复杂化，并可能掩盖启动时的配置错误。
理解代理机制：Spring 通过 CGLIB 或 JDK 动态代理来实现延迟加载。这意味着被@Lazy标记的 Bean 在注入时实际上是代理对象。这可能会影响getClass()、类型转换（cast）和@Autowired到具体类型的操作。
与@Scope的交互：对于原型作用域（prototype）的 Bean，@Lazy注解实际上没有意义，因为每次请求都会创建一个新实例。
配置类本身也可以标记为@Lazy：这意味着该配置类中定义的所有@Bean方法默认都会延迟初始化，除非某个@Bean方法显式地标注了@Lazy(false)。
调试：在调试时，注意 Bean 的初始化日志。延迟加载的 Bean 其初始化日志会在首次请求时出现，而不是在应用启动时。