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构造器注入的测试写法差异）