架构与系统设计 / 系统课时
接口层为什么不应该直接操作 Repository
接口层为什么不应该直接操作 Repository
接口层负责接收外部请求并完成协议转换,不应该顺手把 Repository 当成数据访问捷径。正确做法是让 Controller 调用应用服务,由应用层统一编排事务、权限和领域操作,Repository 只服务于领域与应用流程。
学习目标
- 识别 Controller 直接访问 Repository 带来的职责泄漏
- 理解应用层为什么是业务流程与事务边界的集中位置
- 能把接口层改造成只负责协议适配的薄入口
直接访问 Repository 会破坏什么
Controller 如果直接调用 Repository,最先出现的问题通常不是“代码不能跑”,而是同一业务流程被拆散到多个入口。HTTP 接口可能先查权限再保存,MQ 消费者可能直接保存,后台任务又写一套事务逻辑。随着入口增多,校验顺序、权限规则和事务边界很容易不一致。
Repository 的职责是提供面向领域对象的持久化抽象,不是替接口层完成业务编排。接口层越过应用层后,业务流程就被外部协议绑住了:换成 MQ、RPC 或批处理入口时,要么复制逻辑,要么让不同入口产生不同语义。

应用层应当承接流程边界
应用服务适合集中处理“完成一个用例需要哪些步骤”。它可以先做权限检查,再加载聚合,调用领域行为,最后保存,并把这些动作放进同一事务边界。Controller 只需要把 HTTP 参数转换成应用层命令,再把结果转换成响应。
下面的完整 Java 示例用内存仓储模拟一次“重命名客户”用例。Controller 不知道客户如何保存,只知道调用应用服务。
import java.util.HashMap;
import java.util.Map;
public class Main {
record RenameCustomerCommand(long customerId, String newName) {}
static final class Customer {
private final long id;
private String name;
Customer(long id, String name) {
this.id = id;
this.name = name;
}
void rename(String newName) {
if (newName == null || newName.isBlank()) {
throw new IllegalArgumentException("name must not be blank");
}
this.name = newName;
}
long id() {
return id;
}
String name() {
return name;
}
}
interface CustomerRepository {
Customer findById(long id);
void save(Customer customer);
}
static final class InMemoryCustomerRepository implements CustomerRepository {
private final Map<Long, Customer> data = new HashMap<>();
InMemoryCustomerRepository() {
data.put(1L, new Customer(1L, "Alice"));
}
public Customer findById(long id) {
Customer customer = data.get(id);
if (customer == null) {
throw new IllegalArgumentException("customer not found");
}
return customer;
}
public void save(Customer customer) {
data.put(customer.id(), customer);
}
}
static final class RenameCustomerService {
private final CustomerRepository repository;
RenameCustomerService(CustomerRepository repository) {
this.repository = repository;
}
String handle(RenameCustomerCommand command) {
Customer customer = repository.findById(command.customerId());
customer.rename(command.newName());
repository.save(customer);
return customer.name();
}
}
static final class CustomerController {
private final RenameCustomerService service;
CustomerController(RenameCustomerService service) {
this.service = service;
}
String rename(long id, String name) {
return service.handle(new RenameCustomerCommand(id, name));
}
}
public static void main(String[] args) {
CustomerRepository repository = new InMemoryCustomerRepository();
RenameCustomerService service = new RenameCustomerService(repository);
CustomerController controller = new CustomerController(service);
System.out.println(controller.rename(1L, "Alicia"));
}
}预期输出:
Alicia这里的关键不是类名,而是依赖方向:Controller 依赖应用服务,应用服务依赖 Repository 抽象。以后即使 HTTP Controller 被 MQ Consumer 替换,重命名客户的业务流程仍然只有一份。
哪些逻辑可以留在接口层
接口层可以处理协议相关工作,例如解析路径参数、校验 JSON 是否能反序列化、映射 HTTP 状态码、读取消息头或把 RPC DTO 转成命令。这些逻辑离开当前协议就失去意义,因此不需要塞进应用层。
真正与业务用例有关的规则,例如“谁有权执行”“一次操作要修改哪些聚合”“失败时是否整体回滚”,应该由应用层或领域层承担,而不是散落在 Controller 中。
判断是否已经越层
一个简单判断方法是:如果把 HTTP 换成 MQ 后,你需要复制 Controller 里的大量代码,说明接口层已经承载了业务流程。相反,如果新入口只需构造同一个应用命令并调用同一个应用服务,分层边界通常是健康的。
接口层保持薄并不是追求形式,而是为了让事务、权限和业务流程只存在一个可信入口。这样 Repository 才是持久化边界的一部分,而不是所有外部入口都能随意调用的数据通道。