Spring依赖注入（DI）权威指南：核心方式与最佳实践

结论先行

1. 构造器注入：唯一官方推荐方式，适用于所有强制依赖，保证对象不可变、线程安全、易测试。
2. Setter注入：仅用于可选依赖或需动态更新的场景（如配置热加载）。
3. 字段注入：严禁使用，导致高耦合、破坏封装性、难以测试。
4. 注解选择：优先使用@Autowired（Spring原生），按名称注入可选@Resource（Java标准）。

---

一、核心注入方式详解

1. 构造器注入（强制依赖必选）

核心优势：

• 不可变性：依赖字段可声明为final，确保线程安全。
• 强约束性：对象初始化时即完成依赖注入，避免空指针。
• 低耦合：无需Spring容器，直接通过new实例化测试。

代码示例：

@Service  
public class UserService {  
    private final UserRepository userRepo;  
    private final AuditService auditService;  

    // Spring 4.3+ 单构造方法可省略@Autowired  
    public UserService(UserRepository userRepo, AuditService auditService) {  
        this.userRepo = userRepo;  
        this.auditService = auditService;  
    }  
}  

简化技巧（Lombok）：

@Service  
@RequiredArgsConstructor  
public class OrderService {  
    private final PaymentService paymentService;  
    private final UserService userService;  
}  

适用场景：

• Service层、Repository层等核心组件。
• 所有必须依赖项（无此依赖则对象无法工作）。

---

2. Setter注入（可选依赖慎用）

核心特点：

• 通过Setter方法注入依赖，允许动态更新。

代码示例：

@Service  
public class PaymentService {  
    private PaymentStrategy strategy;  

    @Autowired  
    public void setPaymentStrategy(PaymentStrategy strategy) {  
        this.strategy = strategy; // 运行时动态切换策略  
    }  
}  

适用场景：

• 动态配置更新（如数据库超时时间）。
• 可选依赖（需配合@Autowired(required=false)）。

缺点：

• 对象可能处于“半初始化”状态（依赖未设置时）。
• 掩盖设计问题（如循环依赖）。

---

3. 字段注入（严禁使用）

问题根源：

• 高耦合：依赖Spring容器反射注入，脱离框架无法测试。
• 破坏封装性：依赖关系对外不透明，违反面向对象原则。

反面教材：

@Service  
public class ProductService {  
    @Autowired  // 禁止！  
    private InventoryService inventoryService;  
}  

替代方案：立即重构为构造器注入。

---

4. 注解对比：@Autowired vs @Resource

特性	@Autowired (Spring原生)	@Resource (JSR-250标准)
注入方式	默认按类型注入	默认按名称注入（name属性）
支持场景	构造器、Setter、字段、方法参数	Setter、字段
依赖可选性	支持required=false	不支持（依赖必须存在）
细粒度控制	结合@Qualifier按名称注入	直接通过name属性指定Bean名称

代码示例：

// @Autowired按名称注入（需结合@Qualifier）  
@Service  
public class AuthService {  
    @Autowired  
    @Qualifier("mysqlUserRepo")  
    private UserRepository userRepo;  
}  

// @Resource按名称注入  
@Service  
public class ReportService {  
    @Resource(name = "excelExporter")  
    private DataExporter exporter;  
}  

---

二、其他注入方式补充

1. Java配置类注入（构造器注入的扩展）

通过@Configuration类显式定义Bean，依赖自动注入参数：

@Configuration  
public class AppConfig {  
    @Bean  
    public ServiceA serviceA(ServiceB serviceB) {  
        return new ServiceA(serviceB); // 参数serviceB自动注入  
    }  
}  

优势：

• 显式控制Bean创建逻辑，适合复杂初始化场景。

---

三、最佳实践与避坑指南

1. 强制依赖必须用构造器注入：确保对象初始化后即可完整使用。
2. Setter注入仅用于动态更新：如无必要，直接禁用。
3. 字段注入零容忍：所有@Autowired字段必须重构为构造器注入。
4. 循环依赖是设计问题：
   • 正确做法：重构代码，提取公共模块（如Utils类）。
   • 错误做法：依赖Setter注入掩盖问题。
5. 注解优先级：
   • 优先使用@Autowired（功能更全面）。
   • 按名称注入时可选@Resource。

---

四、总结对比表

注入方式	强制依赖支持	不可变性	可测试性	框架耦合
构造器注入	✔️	✔️	✔️	低
Setter注入	❌	❌	✔️	中
字段注入	❌	❌	❌	高

---

五、终极原则

1. 健壮性 > 便捷性：牺牲少量代码简洁性，换取更高的可维护性和可测试性。
2. 显式 > 隐式：依赖关系应通过代码结构清晰表达，而非隐藏在注解背后。
3. 能用构造器注入的场合都用它，其他方式都是妥协方案。