Spring @Autowired 字段注入波浪线：为什么不推荐 Field Injection 以及构造器注入实践

Posted 2021-11-25 Updated 16 days ago

By Ryan Chen

17~22 min read

前言

在 IntelliJ IDEA 中编写 Spring / Spring Boot 代码时，如果使用字段注入：

@Autowired
private UserService userService;

IDEA 可能会提示：

Field injection is not recommended

这个提示的意思不是 @Autowired 已经废弃，也不是 Spring 不支持字段注入，而是从代码设计、测试和依赖可见性的角度，不推荐使用字段注入（Field Injection）。

更推荐的方式是：

强依赖：使用构造器注入；
可选依赖：使用 Setter 注入；
代码简化：可以配合 Lombok 的 @RequiredArgsConstructor。

@Autowired 是否废弃

@Autowired 没有废弃。它仍然是 Spring 支持的依赖注入注解。

但 Spring 和 IDE 更推荐构造器注入，原因是构造器注入可以更明确地表达“这个 Bean 创建时必须具备哪些依赖”。

另外，从 Spring 4.3 开始，如果一个 Bean 只有一个构造函数，即使不写 @Autowired，Spring 也可以自动使用这个构造函数完成依赖注入。

为什么不推荐字段注入

字段注入写起来最简单：

@RestController
public class UserController {

    @Autowired
    private UserService userService;
}

但它有几个问题：

1. 依赖不明显

只看构造函数时，看不出这个类必须依赖哪些组件。依赖隐藏在字段上，类的创建约束不清晰。

2. 不利于单元测试

字段是 private，测试时如果不启动 Spring 容器，就不容易直接传入 mock 对象，往往需要反射或 Spring Test。

3. 容易破坏不可变性

字段不能声明为 final，对象创建完成后理论上仍可能被修改。构造器注入则可以配合 final 字段，让依赖不可变。

4. 容易掩盖依赖过多的问题

如果一个类字段注入了十几个 Service，代码看起来仍然很短，但实际上这个类职责可能已经过重。构造器参数过多时，问题会更早暴露出来。

推荐方案一：构造器注入

手写构造器注入：

@RestController
public class UserController {

    private final UserService userService;

    public UserController(UserService userService) {
        this.userService = userService;
    }

    @GetMapping("/users")
    public List<User> listUsers() {
        return userService.listUsers();
    }
}

如果只有一个构造器，通常不需要显式写 @Autowired：

public UserController(UserService userService) {
    this.userService = userService;
}

构造器注入的优点：

依赖清晰；
可以使用 final 字段；
更容易单元测试；
Bean 创建时即可保证强依赖存在；
依赖过多时能暴露类职责过重的问题。

推荐方案二：Lombok @RequiredArgsConstructor

如果不想手写构造器，可以使用 Lombok：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

代码可以简化为：

@RequiredArgsConstructor
@RestController
public class UserController {

    private final UserService userService;

    @GetMapping("/users")
    public List<User> listUsers() {
        return userService.listUsers();
    }
}

@RequiredArgsConstructor 会为 final 字段和带 @NonNull 的字段生成构造函数。

旧写法里常见：

@RequiredArgsConstructor(onConstructor = @_(@Autowired))

在大多数现代 Spring 项目中，如果类只有一个构造函数，不需要额外加 @Autowired。直接使用 @RequiredArgsConstructor 即可。

可选依赖：Setter 注入

如果某个依赖不是必须的，可以使用 Setter 注入：

@Component
public class ReportService {

    private AuditService auditService;

    @Autowired(required = false)
    public void setAuditService(AuditService auditService) {
        this.auditService = auditService;
    }
}

注意：Setter 注入的字段不能声明为 final，因为它是在对象创建后再设置的。

Setter 注入适合：

可选依赖；
后置配置；
某些需要避免循环依赖的特殊场景。

但如果是业务强依赖，仍然优先使用构造器注入。

三种注入方式对比

注入方式	优点	缺点	推荐场景
字段注入	写法最短	依赖隐藏、不利于测试、不能 final	不推荐作为默认方式。
构造器注入	依赖明确、支持 final、便于测试	依赖过多时代码较长	强依赖，默认推荐。
Setter 注入	支持可选依赖	对象创建后才注入，不能 final	可选依赖、后置配置。

常见误区

1. IDEA 波浪线是不是编译错误？

不是。它是代码检查提示，不影响编译。但它提醒你字段注入不是最佳实践。

2. @Autowired 是不是不能用了？

不是。@Autowired 仍然可用。问题在于“字段注入”这种写法不推荐，而不是 @Autowired 注解本身不可用。

3. 构造器注入一定要写 @Autowired 吗？

如果只有一个构造器，一般不需要。Spring 会自动使用这个构造器注入依赖。

4. Lombok 会不会影响 Spring 注入？

不会。Lombok 在编译期生成构造器，Spring 运行时看到的是正常构造函数。

5. 循环依赖怎么办？

构造器注入会更早暴露循环依赖问题。正确做法通常不是退回字段注入，而是重新审视模块职责，拆分服务或引入事件、接口、延迟加载等方式。

小结

IDEA 提示 Field injection is not recommended 的核心原因是：字段注入虽然简洁，但不利于表达强依赖、不利于测试，也不利于保持对象不可变。

推荐实践是：

强依赖优先使用构造器注入；
单构造器场景通常不需要显式 @Autowired；
Lombok @RequiredArgsConstructor 可以减少模板代码；
可选依赖使用 Setter 注入；
字段注入不作为默认选择。

参考资料

Java

Spring Spring Boot Autowired 依赖注入构造器注入 Lombok IDEA 代码规范

License: CC BY 4.0

前言