Java 后端 / 系统课时
使用构造器注入依赖
使用构造器注入依赖
本课用一个可测试的用户查询服务演示构造器注入:依赖在对象创建时一次性交齐,业务类不依赖隐藏的容器状态,并能在单元测试中直接替换仓储实现。
学习目标
- 使用构造器声明服务的必需依赖
- 理解构造器注入与单一职责、不可变性的关系
- 不启动 Spring 容器也能完成服务单元测试
为什么优先使用构造器注入
构造器参数就是对象的依赖清单。只要 UserService 创建成功,就能确定它持有可用的 UserRepository;字段可以声明为 final,避免运行过程中被替换。相比字段注入,这种方式不会隐藏依赖,也不会让业务对象只能由 Spring 反射创建。

编写服务与仓储接口
下面是片段示例,文件应分别放入现有 Spring Boot 3 项目的 com.example.user 包;测试依赖由 spring-boot-starter-test 提供。
java
// User.java
package com.example.user;
public record User(Long id, String name) {}
// UserRepository.java
package com.example.user;
import java.util.Optional;
public interface UserRepository {
Optional<User> findById(Long id);
}
// UserService.java
package com.example.user;
import org.springframework.stereotype.Service;
@Service
public class UserService {
private final UserRepository userRepository;
// 必需依赖只在构造时注入,创建后的引用保持不变
public UserService(UserRepository userRepository) {
this.userRepository = userRepository;
}
public String getDisplayName(Long id) {
return userRepository.findById(id)
.map(User::name)
.orElseThrow(() -> new IllegalArgumentException("用户不存在: " + id));
}
}
// UserServiceTest.java
package com.example.user;
import org.junit.jupiter.api.Test;
import java.util.Optional;
import static org.junit.jupiter.api.Assertions.assertEquals;
class UserServiceTest {
@Test
void shouldReturnDisplayName() {
// 使用 lambda 充当仓储替身,不需要启动 Spring 容器
UserRepository fakeRepository =
id -> Optional.of(new User(id, "Alice"));
UserService service = new UserService(fakeRepository);
assertEquals("Alice", service.getDisplayName(1L));
}
}执行指定测试:
bash
./mvnw -q -Dtest=UserServiceTest test && printf 'TEST_OK\n'预期输出:
text
TEST_OK让依赖边界反映单一职责
服务只负责“读取用户并转换为展示名称”,数据从哪里来由 UserRepository 决定。这样,数据库访问、远程接口或内存实现都可以替换,而服务逻辑不需要修改。测试只关心服务契约,因此执行速度快,失败原因也更集中。
当一个构造器出现大量无关参数时,通常不是注入方式的问题,而是类承担了过多职责。应先按业务能力拆分服务,再考虑聚合少量真正相关的协作者,不要用字段注入掩盖复杂度。
处理多实现与循环依赖
同一接口只有一个 Bean 时,Spring 会按类型完成注入。存在多个实现时,应通过 @Primary 指定默认实现,或在构造器参数上使用 @Qualifier 明确选择,避免依赖解析含糊。
如果启动时报告循环依赖,不要改回字段注入或滥用延迟加载。循环通常说明两个服务互相承担对方职责,应提取第三个协调组件、领域事件或更稳定的下层接口来打破双向引用。
按自己的节奏,确认真正理解。