依赖注入DIDependency Injection是 Spring 框架最核心、最基础的特性也是 SpringBoot 自动配置、Bean 管理、AOP、事务、微服务组件生效的底层基石。绝大多数开发者仅会使用Autowired、Resource注解完成注入但对 DI 的底层原理、注入方式、优先级、生命周期、循环依赖解决方案、适用场景认知片面极易出现空指针、注入失败、循环报错、组件覆盖等线上问题。本文基于 SpringBoot 2.x/3.x 通用规范通过多维度表格全景对比底层源码流程实战场景误区避坑全方位梳理依赖注入核心知识点构建完整的 DI 知识体系适配面试、开发、架构落地全场景。一、依赖注入核心概念与本质1.1 核心定义依赖一个类需要调用另一个类的方法/属性才能完成业务功能二者形成依赖关系。传统开发中类主动通过new创建依赖对象耦合度极高。依赖注入DI将对象的创建、管理、依赖赋值全权交给 Spring IOC 容器开发者无需手动 new 对象容器自动实例化 Bean、组装依赖关系实现控制反转IOC彻底解耦业务代码。1.2 传统开发 vs Spring DI 开发对比表对比维度传统手动 new 开发SpringBoot DI 依赖注入对象创建方式开发者手动 new 实例Spring IOC 容器自动实例化依赖赋值方式代码硬编码赋值主动依赖容器自动注入被动接收依赖代码耦合度高代码强依赖具体实现类极低依赖抽象接口面向接口编程对象复用性每次 new 都是新对象资源浪费默认单例 Bean全局复用节省资源维护成本依赖变更需改全部代码扩展性差无需改业务代码通过配置/注解切换实现事务、AOP 能力无无法使用 Spring 增强能力支持所有 Spring 特性基于 DI 生效1.3 IOC 与 DI 核心关系IOC控制反转是思想DI依赖注入是实现控制反转将对象控制权从开发者交给容器反转资源管控权限依赖注入容器实现 IOC 思想的具体手段是 Spring 解耦的核心落地方式。二、SpringBoot 三种核心注入方式全景对比Spring 官方定义三种标准依赖注入方式构造器注入、Setter 注入、字段注入三种方式的优先级、底层逻辑、适用场景、优缺点差异极大。2.1 三种注入方式全维度对比表对比维度构造器注入官方推荐Setter 方法注入字段注入Autowired 直接注入实现方式通过类构造方法传入依赖参数通过 Java Bean Setter 方法赋值类属性直接添加 Autowired/Resource注入时机Bean实例化阶段同步注入Bean 实例化完成后属性赋值阶段注入Bean 实例化后后置处理器统一注入必填依赖支持天然支持强制注入避免空指针可选依赖可动态修改依赖默认必填需 requiredfalse 设为可选循环依赖解决无法解决直接抛出异常可以解决单例循环依赖可以解决单例循环依赖代码可测试性极高无 Spring 环境可手动 new 传参测试较高可手动调用 Setter 赋值极差强依赖 Spring 容器无法独立单元测试Spring 官方态度强制推荐Spring4.3 首选兼容保留适用于可选依赖不推荐代码耦合隐蔽隐患多适用场景所有必填核心依赖Service、Dao 核心组件非必须、可动态切换的可选依赖快速开发、简单项目不用于正式规范开发2.2 三种注入方式代码示例1. 构造器注入标准推荐SpringBoot 4.3 单构造器可省略 Autowired 注解Service public class OrderService { // 单构造器自动注入 private final UserService userService; public OrderService(UserService userService) { this.userService userService; } }2. Setter 注入Service public class OrderService { private UserService userService; Autowired public void setUserService(UserService userService) { this.userService userService; } }3. 字段注入不推荐Service public class OrderService { Autowired private UserService userService; }三、主流注入注解对比Autowired、Resource、Qualifier开发中最常用的三个注入注解底层规则、匹配逻辑、来源、容错性完全不同是 DI 核心高频考点。3.1 注解全维度对比表对比维度AutowiredResourceQualifier注解来源Spring 自定义注解JSR-250 Java 原生标准注解Spring 辅助注解默认匹配规则默认按类型byType注入默认按名称byName注入名称匹配失败再按类型精准指定 Bean 名称解决多实例冲突必填属性requiredtrue默认必填可设为 false默认必须注入无 required 配置无注入属性仅作匹配修饰多 Bean 冲突场景同类型多 Bean 直接报错需配合 Qualifier按变量名匹配 Bean可规避部分冲突强制指定注入 Bean 名称彻底解决冲突底层依赖Spring IOC 专属脱离 Spring 失效Java 标准兼容所有 DI 容器配合 Autowired 使用不可单独使用适用场景绝大多数 SpringBoot 业务注入需要跨容器兼容、按名称精准注入场景接口多实现类、同类型多 Bean 场景3.2 多实现类注入冲突解决方案当一个接口有多个实现类时Autowired 按类型注入会抛出NoUniqueBeanDefinitionException唯一 Bean 冲突异常两种标准解决方案使用Qualifier Autowired指定 Bean 名称使用Resource变量名与 Bean 名称一致自动匹配。四、Spring DI 底层执行流程核心原理依赖注入发生在 Spring IOC 容器启动、Bean 初始化阶段完整流程分为扫描定位、实例化、属性填充、初始化、完成注入五个核心步骤。4.1 DI 完整执行流程表执行阶段核心操作关键底层组件1. 资源扫描SpringBoot 启动时通过包扫描识别所有带 Service、Component、Repository 的组件生成 Bean 定义信息BeanDefinitionBeanDefinitionScanner2. Bean 实例化容器根据 BeanDefinition通过反射调用构造器创建 Bean 空对象此时属性全部为空AbstractAutowireCapableBeanFactory3. 依赖注入核心调用 Bean 后置处理器解析 Autowired/Resource 注解从容器中匹配依赖 Bean完成属性赋值AutowiredAnnotationBeanPostProcessor4. 初始化方法执行执行 PostConstruct 标注方法、InitializingBean 初始化方法完成业务初始化Bean 初始化处理器5. 完成注入Bean 完全就绪存入单例池全局可直接使用Spring 单例缓存池五、Bean 作用域与 DI 注入关联关系依赖注入的效果、对象复用、循环依赖问题完全依赖 Bean 的作用域不同作用域注入逻辑差异巨大。5.1 核心作用域 DI 特性对比表作用域生命周期DI 注入特性循环依赖支持singleton默认单例容器启动创建全局唯一全局注入同一个 Bean 对象性能最高支持 setter/字段注入不支持构造器prototype多例每次注入创建新对象每次获取都是全新实例无对象复用完全不支持直接报错request单次 HTTP 请求有效请求内统一对象跨请求重新注入不支持session单次会话有效同会话复用对象会话过期销毁不支持六、DI 核心难点循环依赖全景解析循环依赖是 DI 开发中最常见的报错问题核心场景A 依赖 BB 依赖 A。Spring 仅能解决单例模式下的字段、Setter 循环依赖。6.1 各类注入循环依赖支持情况表注入方式单例 Bean多例 Bean报错原因字段注入✅ 支持解决❌ 不支持多例无缓存无法提前暴露对象Setter 注入✅ 支持解决❌ 不支持多例无缓存机制构造器注入❌ 不支持❌ 不支持实例化必须传参无法提前暴露空对象6.2 Spring 循环依赖解决核心原理依靠 Spring三级缓存机制一级缓存存放完全初始化好的单例 Bean二级缓存存放已实例化、未完成注入的半成品 Bean三级缓存存放 Bean 工厂用于提前暴露对象引用。字段/Setter 注入可先创建空对象存入缓存再完成依赖赋值构造器注入必须初始化时传入完整依赖无法借助缓存因此无法解决循环依赖。七、DI 常见报错与解决方案对照表7.1 高频异常场景全景表异常信息报错原因解决方案NoSuchBeanDefinitionException容器中无对应 Bean未托管、包扫描不到、注解缺失添加 Service/Component、检查包扫描范围、确认 Bean 已实例化NoUniqueBeanDefinitionException接口多实现类byType 注入匹配多个 Bean使用 Qualifier 指定名称 / Resource 按名称注入BeanCurrentlyInCreationException构造器循环依赖无法解决改为字段/Setter 注入或重构代码解除循环依赖NullPointerException 注入空指针手动 new 对象、静态方法调用、未交给容器管理禁止手动 new统一使用容器注入非静态调用 Bean八、DI 企业级最佳实践与规范8.1 开发规范汇总表开发场景推荐规范禁止写法普通业务组件注入构造器注入 final 修饰保证不可变、必填禁止长期使用字段注入可选依赖注入使用 Setter 注入灵活配置依赖必填依赖使用 Setter 注入多实现类注入Autowired Qualifier 精准匹配依赖变量名侥幸匹配代码不健壮工具类/静态方法通过 Spring 上下文获取 Bean非静态注入静态属性直接 Autowired 注入永久空指针循环依赖处理优先代码重构彻底解耦依赖缓存机制强行规避遗留隐患九、全文核心总结1、DI 本质依赖注入是 Spring IOC 思想的落地实现核心是容器管控对象、自动组装依赖彻底解耦代码2、注入优先级构造器注入官方首选 Setter 注入可选依赖 字段注入仅快速开发3、注解核心差异Autowired 默认按类型Resource 默认按名称Qualifier 精准解决多 Bean 冲突4、循环依赖边界仅单例模式下字段、Setter 注入可解决构造器、多例模式完全无法解决5、落地原则业务开发统一使用构造器注入final拒绝字段注入滥用规避空指针、循环依赖、注入冲突问题。