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

Spring Boot 中各种 Bean 注入方式的优缺点详解（附实战代码）

news 2026/5/12 10:21:12

视频看了几百小时还迷糊？关注我，几分钟让你秒懂！

在 Spring Boot 开发中，依赖注入（Dependency Injection, DI）是最核心的概念之一。它帮助我们解耦组件、提高可测试性和维护性。但很多初学者面对@Autowired、构造器注入、Setter 注入、字段注入等不同方式时常常一头雾水：到底该用哪种？它们有什么区别？今天我们就来彻底讲清楚！

一、需求场景

假设你正在开发一个电商系统，有一个OrderService需要调用UserService和PaymentService来完成下单逻辑。

public class OrderService { private UserService userService; private PaymentService paymentService; // ...业务方法 }

那么，如何将UserService和PaymentService注入到OrderService中呢？

Spring 提供了多种注入方式，下面我们一一分析。

二、四种常见注入方式及优缺点对比

1. 字段注入（Field Injection）【不推荐】

@Service public class OrderService { @Autowired private UserService userService; @Autowired private PaymentService paymentService; public void createOrder() { userService.validateUser(); paymentService.processPayment(); } }

✅ 优点：

代码简洁，写起来快。
IDE 自动补全支持好。

❌ 缺点（严重！）：

无法创建不可变对象：字段是private且没有 setter，外部无法设置，但 Spring 反射强行赋值，破坏封装性。
难以单元测试：无法通过new OrderService(userService, paymentService)构造，必须依赖 Spring 容器或反射设值。
容易产生 NPE：如果忘记加@Autowired或组件未被扫描，运行时才报错。
违反单一职责原则：类依赖太多时不易察觉。

⚠️ Spring 官方从 2017 年起就不推荐使用字段注入，Spring 团队成员多次公开表示应避免。

2. Setter 注入（Setter Injection）

@Service public class OrderService { private UserService userService; private PaymentService paymentService; @Autowired public void setUserService(UserService userService) { this.userService = userService; } @Autowired public void setPaymentService(PaymentService paymentService) { this.paymentService = paymentService; } public void createOrder() { userService.validateUser(); paymentService.processPayment(); } }

✅ 优点：

支持可选依赖（可以不调用 setter）。
对象创建后可以重新设置依赖（灵活性高）。

❌ 缺点：

依赖不是强制的，可能导致对象处于不完整状态。
仍需依赖 Spring 调用 setter，单元测试仍不够方便。
多个 setter 方法使类膨胀。

📌 适用场景：可选依赖（如插件、策略模式中的可替换组件）。

3. 构造器注入（Constructor Injection）【强烈推荐！】

@Service public class OrderService { private final UserService userService; private final PaymentService paymentService; public OrderService(UserService userService, PaymentService paymentService) { this.userService = userService; this.paymentService = paymentService; } public void createOrder() { userService.validateUser(); paymentService.processPayment(); } }

注意：Spring Boot 2.6+ 默认启用构造器注入，无需加@Autowired（只要只有一个构造函数）。

✅ 优点：

强制依赖：确保对象创建时所有必要依赖都已注入。
不可变性：配合final字段，保证线程安全和对象完整性。
易于单元测试：直接new OrderService(mockUser, mockPay)即可。
符合 SOLID 原则：清晰暴露依赖关系，便于重构。

❌ 缺点：

如果依赖太多（>5 个），构造函数会很长（但这其实是设计问题，说明类职责过重！）。

✅官方推荐方式！Spring 文档明确指出：优先使用构造器注入。

4. 接口注入（Interface Injection）【极少使用】

需要实现特定接口，由容器调用注入方法。Spring原生不支持此方式，属于早期 DI 框架（如 Avalon）的做法。

❌ 不适用于 Spring Boot，直接忽略。

三、反例演示：字段注入导致的问题

反例：单元测试失败

// 使用字段注入的 OrderService @Service public class BadOrderService { @Autowired private UserService userService; // 私有字段，无 setter/构造器 public String process() { return userService.getName(); // 如果 userService 为 null，NPE！ } } // 单元测试 @Test void testProcess() { UserService mockUser = mock(UserService.class); when(mockUser.getName()).thenReturn("Alice"); BadOrderService service = new BadOrderService(); // 此时 userService 为 null！ assertThrows(NullPointerException.class, service::process); }

💥 你必须用ReflectionTestUtils.setField()才能设值，非常麻烦！

正确做法：构造器注入 + 单元测试

@Test void testProcessWithConstructorInjection() { UserService mockUser = mock(UserService.class); when(mockUser.getName()).thenReturn("Alice"); GoodOrderService service = new GoodOrderService(mockUser); // 直接传入 assertEquals("Alice", service.process()); // 测试通过！ }

四、注意事项 & 最佳实践

默认使用构造器注入：除非依赖是可选的。
避免字段注入：尤其在团队协作项目中，容易埋雷。
依赖过多？考虑拆分类：一个类依赖超过 4~5 个 Bean，可能违反单一职责。
循环依赖问题：
- 构造器注入无法解决循环依赖（启动报错）。
- 字段/Setter 注入可通过三级缓存解决，但应重构代码避免循环依赖。
Lombok 简化构造器（可选）：

@Service @RequiredArgsConstructor // 自动生成 final 字段的构造器 public class OrderService { private final UserService userService; private final PaymentService paymentService; }