为什么官方不推荐使用 @Autowired?

科技   2024-11-29 15:04   安徽  

👉 欢迎加入小哈的星球,你将获得: 专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸:仿小红书(微服务架构)》 正在持续爆肝中,基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍
  • 《从零手撸:前后端分离博客项目(全栈开发)》 2期已完结,演示链接:http://116.62.199.48/;

截止目前,累计输出 71w+ 字,讲解图 3088+ 张,还在持续爆肝中.. 后续还会上新更多项目,目标是将 Java 领域典型的项目都整一波,如秒杀系统, 在线商城, IM 即时通讯,Spring Cloud Alibaba 等等,戳我加入学习,解锁全部项目,已有2400+小伙伴加入

前言

很多人刚接触 Spring 的时候,对 @Autowired 绝对是爱得深沉。

一个注解,轻松搞定依赖注入,连代码量都省了。

谁不爱呢?

但慢慢地,尤其是跑到稍微复杂点的项目里,@Autowired 就开始给你整点幺蛾子。

于是,官方Spring 4.0开始不建议无脑用 @Autowired,而是更推荐构造函数注入。

为什么?

@Autowired 不行吗?并不是。

它可以用,但问题是:它不是无敌的,滥用起来容易埋坑。

下面就来聊聊为啥官方建议你慎用 @Autowired,顺便再带点代码例子,希望对你会有所帮助。

1. 容易导致隐式依赖

很多小伙伴在工作中喜欢直接写:

@Service
public class MyService {
    @Autowired
    private MyRepository myRepository;
}

看着挺简单,但问题来了:类的依赖关系藏得太深了

  • 你看这段代码,MyServiceMyRepository 的关系其实是个“隐形依赖”,全靠 @Autowired 来注入。
  • 如果有个同事刚接手代码,打开一看,完全不知道 myRepository 是啥玩意儿、怎么来的,只有通过 IDE 或运行时才能猜出来。

隐式依赖的结果就是,代码看起来简单,但维护起来费劲。

后期加个新依赖,或者改依赖顺序,分分钟把人搞糊涂。

怎么破?

构造函数注入 替代。

@Service
public class MyService {
    private final MyRepository myRepository;

    // 构造函数注入,依赖一目了然
    public MyService(MyRepository myRepository) {
        this.myRepository = myRepository;
    }
}

这样做的好处是:

  • 依赖清晰:谁依赖谁,直接写在构造函数里,明明白白。
  • 更易测试:构造函数注入可以手动传入 mock 对象,方便写单元测试。

2. 会导致强耦合

再举个例子,很多人喜欢直接用 @Autowired 注入具体实现类,比如:

@Service
public class MyService {
    @Autowired
    private SpecificRepository specificRepository;
}

表面上没毛病,但这是硬邦邦地把 MyServiceSpecificRepository 绑死了。

万一有一天,业务改了,需要切换成另一个实现类,比如 AnotherSpecificRepository,你得改代码、改注解,连带着测试也崩。

怎么破?

用接口和构造函数注入,把依赖解耦。

@Service
public class MyService {
    private final Repository repository;

    public MyService(Repository repository) {
        this.repository = repository;
    }
}

然后通过 Spring 的配置文件或者 @Configuration 类配置具体实现:

@Configuration
public class RepositoryConfig {
    @Bean
    public Repository repository() {
        return new SpecificRepository();
    }
}

这么搞的好处是:

  • 灵活切换:改实现类时,不用动核心逻辑代码。
  • 符合面向接口编程的思想:降低耦合,提升可扩展性。

3. 容易导致 NullPointerException

有些小伙伴喜欢这么写:

@Service
public class MyService {
    @Autowired
    private MyRepository myRepository;

    public void doSomething() {
        myRepository.save(); // 啪!NullPointerException
    }
}

问题在哪?如果 Spring 容器还没来得及注入依赖,你的代码就跑了(比如在构造函数或初始化方法中直接调用依赖),结果自然就是 NullPointerException

怎么破?

用构造函数注入,彻底干掉 null 的可能性。

@Service
public class MyService {
    private final MyRepository myRepository;

    public MyService(MyRepository myRepository) {
        this.myRepository = myRepository; // 确保依赖在对象初始化时就已注入
    }

    public void doSomething() {
        myRepository.save();
    }
}

构造函数注入的另一个优点是:依赖注入是强制的,Spring 容器不给你注入就报错,让问题早暴露。

4.自动装配容易搞出迷惑行为

Spring 的自动装配机制有时候是“黑魔法”,尤其是当你的项目里有多个候选 Bean 时。比如:

@Service
public class MyService {
    @Autowired
    private Repository repository; // 容器里有两个 Repository 实现类,咋办?
}

如果有两个实现类,比如 SpecificRepositoryAnotherRepository,Spring 容器直接报错。解决方法有两种:

  • 指定 @Primary
  • @Qualifier 手动指定。

但这些方式都让代码看起来更复杂了,还可能踩坑。

怎么破?

构造函数注入 + 显式配置。

@Configuration
public class RepositoryConfig {
    @Bean
    public Repository repository() {
        return new SpecificRepository();
    }
}

你明确告诉 Spring 该用哪个实现类,别让容器帮你猜,省得以后“配错药”。

5. 写单元测试非常痛苦

最后,聊聊测试的事儿。

@Autowired 依赖 Spring 容器才能工作,但写单元测试时,大家都不想起 Spring 容器(麻烦、慢)。结果就是:

  • 字段注入:没法手动传入 mock 对象。
  • 自动装配:有时候不清楚用的 Bean 是哪个,测试难搞。

怎么破?

构造函数注入天生就是为单元测试设计的。

public class MyServiceTest {
    @Test
    public void testDoSomething() {
        MyRepository mockRepository = mock(MyRepository.class);
        MyService myService = new MyService(mockRepository);

        // 测试逻辑
    }
}

看见没?

直接传入 mock 对象,测试简单、优雅。

总结

简单总结下问题:

  1. 隐式依赖让代码可读性差。
  2. 强耦合违背面向接口编程。
  3. 字段注入容易 NPE。
  4. 自动装配有坑。
  5. 单元测试不好写。

那到底咋办?用 构造函数注入,清晰、稳健、测试友好,官方推荐不是没道理的。

但话说回来,@Autowired 也不是不能用,只是你得分场景。

开发中,养成用构造函数注入的习惯,能让你的代码更健壮,少挖坑,多干活!

👉 欢迎加入小哈的星球,你将获得: 专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸:仿小红书(微服务架构)》 正在持续爆肝中,基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17..., 点击查看项目介绍
  • 《从零手撸:前后端分离博客项目(全栈开发)》 2期已完结,演示链接:http://116.62.199.48/;

截止目前,累计输出 71w+ 字,讲解图 3088+ 张,还在持续爆肝中.. 后续还会上新更多项目,目标是将 Java 领域典型的项目都整一波,如秒杀系统, 在线商城, IM 即时通讯,Spring Cloud Alibaba 等等,戳我加入学习,解锁全部项目,已有2400+小伙伴加入


1. 我的私密学习小圈子,从0到1手撸企业实战项目!

2. Spring Boot 插件化开发模式,真香!

3. 一文彻底搞懂 zookeeper 核心知识点

4. Java 导出 Excel 利器:JXLS

最近面试BAT,整理一份面试资料Java面试BATJ通关手册,覆盖了Java核心技术、JVM、Java并发、SSM、微服务、数据库、数据结构等等。

获取方式:点“在看”,关注公众号并回复 Java 领取,更多内容陆续奉上。

PS:因公众号平台更改了推送规则,如果不想错过内容,记得读完点一下在看,加个星标,这样每次新文章推送才会第一时间出现在你的订阅列表里。

“在看”支持小哈呀,谢谢啦

小哈学Java
码龄9年,前某厂中台研发。专注于Java领域干货分享,不限于BAT面试, 算法,数据库,Spring Boot, 微服务,高并发, JVM, Docker容器,ELK相关知识,期待与您一同进步。
 最新文章