架构与系统设计 / 系统课时
Controller 直接调 Mapper 为什么危险
Controller 直接调 Mapper 为什么危险
Controller 直接调用 Mapper 能很快完成“接收参数、改数据库、返回结果”,但它把业务用例压缩成了一条数据访问链路。随着 Web、后台任务和消息消费等入口增多,同一规则会被复制到多个地方,并可能产生不同结果。本节用订单取消场景拆解这种风险和正确的分层边界。
学习目标
- 理解 Controller 直接调用 Mapper 会绕过哪些业务职责
- 识别多入口场景下规则重复与不一致的根因
- 能把 Controller、应用服务、领域对象和 Mapper 放回合适职责
快捷链路为什么会失控
典型坏味道是 Controller 校验几个字段后直接调用 mapper.updateStatus()。此时 Controller 同时承担协议适配、业务判断和持久化编排三个职责。
真正的危险不是“层数少”,而是业务规则绑定到了某一个入口。假设 HTTP Controller 判断“已发货不能取消”,后来又增加消息消费者处理自动取消。如果消费者直接调用同一个 Mapper,却没有复制完整判断,就可能写入 HTTP 路径永远不会产生的非法状态。

用代码观察同一规则如何分叉
下面的纯 Java 示例先模拟两个入口各自处理规则,再用仓储接口和应用服务收拢同一个取消用例。真实项目中,MapperOrderRepository 可以由 MyBatis Mapper 实现数据库访问。
public class LayeringDemo {
enum Status { PAID, SHIPPED, CANCELLED }
static class OrderMapper {
private Status status = Status.SHIPPED;
Status findStatus() {
return status;
}
void updateStatus(Status newStatus) {
status = newStatus;
}
}
static class BadHttpController {
void cancel(OrderMapper mapper) {
if (mapper.findStatus() == Status.SHIPPED) {
System.out.println("http=rejected");
return;
}
mapper.updateStatus(Status.CANCELLED);
}
}
static class BadMessageConsumer {
void cancel(OrderMapper mapper) {
mapper.updateStatus(Status.CANCELLED);
}
}
static class Order {
private Status status;
Order(Status status) {
this.status = status;
}
Status getStatus() {
return status;
}
void cancel() {
if (status == Status.SHIPPED) {
throw new IllegalStateException("shipped order cannot be cancelled");
}
status = Status.CANCELLED;
}
}
interface OrderRepository {
Order load();
void save(Order order);
}
static class MapperOrderRepository implements OrderRepository {
private final OrderMapper mapper;
MapperOrderRepository(OrderMapper mapper) {
this.mapper = mapper;
}
public Order load() {
return new Order(mapper.findStatus());
}
public void save(Order order) {
mapper.updateStatus(order.getStatus());
}
}
static class CancelOrderApplicationService {
private final OrderRepository repository;
CancelOrderApplicationService(OrderRepository repository) {
this.repository = repository;
}
void cancel() {
Order order = repository.load();
order.cancel();
repository.save(order);
}
}
public static void main(String[] args) {
OrderMapper badMapper = new OrderMapper();
new BadHttpController().cancel(badMapper);
new BadMessageConsumer().cancel(badMapper);
System.out.println("badDatabase=" + badMapper.findStatus());
OrderMapper goodMapper = new OrderMapper();
CancelOrderApplicationService service =
new CancelOrderApplicationService(new MapperOrderRepository(goodMapper));
try {
service.cancel();
} catch (IllegalStateException e) {
System.out.println("layered=" + e.getMessage());
}
System.out.println("goodDatabase=" + goodMapper.findStatus());
}
}预期输出
http=rejected
badDatabase=CANCELLED
layered=shipped order cannot be cancelled
goodDatabase=SHIPPED坏路径中,HTTP 入口拒绝了取消,但消息入口仍把数据库改成 CANCELLED。分层路径中,应用服务加载实体并调用 cancel();实体拒绝非法转换,因此仓储不会保存新状态,数据库仍是 SHIPPED。
每一层应该做什么
Controller 的职责是把 HTTP 请求转换为应用层可理解的命令,并把执行结果转换为 HTTP 响应。它不应该知道某条 SQL 怎么写,也不应该成为业务规则的唯一保存位置。
应用服务负责一个用例的流程边界,例如加载订单、调用 order.cancel()、保存订单,并在需要时协调事务或发布事件。领域对象负责“什么状态变化是合法的”。Mapper 或仓储适配器负责数据库访问细节。
在使用 MyBatis 时,Mapper 可以存在于基础设施实现中;领域层更适合依赖 OrderRepository 这类面向领域语义的接口。这样应用层表达的是“保存订单”,而不是“执行某个 UPDATE 语句”。
怎样从直接调用改回来
重构时不必一次重写全部代码。先选择一条容易出错的业务链路,把规则集中起来:
- 从 Controller 中抽出一个应用用例,例如
CancelOrderApplicationService。 - 把状态合法性判断移到
Order.cancel()等领域方法。 - 让应用服务通过仓储接口加载和保存聚合。
- 让 MyBatis Mapper 留在仓储实现内部。
- 让 Controller、定时任务和消息消费者都复用同一个应用用例。
分层的目的不是增加文件数量,而是让业务规则只有一个可信入口、让数据库访问可以替换、让不同适配器复用同一用例。只要 Controller 可以绕过领域规则直接改库,系统就仍然存在产生不一致状态的通道。