Spring官方推荐构造器注入为首选，所有必需依赖须通过构造函数传入并用final修饰；可选依赖用@Autowired(required=false)的Setter注入；依赖类型必须为接口，配合CI检查与代码扫描保障规范落地。
团队项目中规范依赖注入标准，核心是统一方式、明确边界、兼顾可测性与可维护性。Spring官方自5.x起已明确推荐构造器注入为首选，这不仅是技术选择，更是团队协作的契约基础。
统一采用构造器注入作为主方式
所有必需依赖必须通过构造函数传入，并用final修饰字段：
- 禁止在Service、Repository、Controller等核心组件中使用
@Autowired private XxxService字段注入 - 构造器参数即该类的“依赖合约”，一眼可知它依赖什么、缺了哪个会启动失败
- Spring 4.3+支持单构造器自动装配，无需显式写
@Autowired，减少冗余注解 - 测试时直接new对象并传入mock，不依赖Spring容器，单元测试轻量可靠
区分必需依赖与可选依赖
构造器只承载不可缺失的依赖；对可选、动态变更或有默认实现的依赖，用Setter注入并配合@Autowired(required = false)：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 例如日志上报服务、异步通知客户端等非核心路径依赖
- Setter方法需命名清晰（如
setEmailSender(EmailSender sender)），避免泛化命名 - 禁止在Setter里做复杂逻辑或状态校验，仅做赋值
约束接口抽象与实现分离
依赖注入要真正起效，前提是依赖项是接口而非具体类：
- 所有被注入的类型必须声明为接口（如
UserRepository），实现类（如JdbcUserRepository）仅在配置层注册 - 禁止构造器参数写
new JdbcUserRepository()或直接注入实现类实例 - 接口设计遵循“小而专”，避免大而全的
BaseService，防止隐式耦合
建立代码扫描与CI检查机制
光靠约定不够，需技术手段兜底：
- 在SonarQube或Checkstyle中配置规则：禁止
@Autowired出现在字段上，检测非final依赖字段 - CI流水线加入编译期检查：使用ArchUnit编写断言，例如“所有@Service类的构造器参数必须是接口类型”
- 新成员入职时提供模板代码和反例对比（如字段注入vs构造器注入的测试写法差异）
