架构与系统设计 / 系统课时

Controller 直接调 Mapper 为什么危险

Controller 直接调 Mapper 为什么危险

Controller 直接调用 Mapper 能很快完成“接收参数、改数据库、返回结果”,但它把业务用例压缩成了一条数据访问链路。随着 Web、后台任务和消息消费等入口增多,同一规则会被复制到多个地方,并可能产生不同结果。本节用订单取消场景拆解这种风险和正确的分层边界。

学习目标

  • 理解 Controller 直接调用 Mapper 会绕过哪些业务职责
  • 识别多入口场景下规则重复与不一致的根因
  • 能把 Controller、应用服务、领域对象和 Mapper 放回合适职责

快捷链路为什么会失控

典型坏味道是 Controller 校验几个字段后直接调用 mapper.updateStatus()。此时 Controller 同时承担协议适配、业务判断和持久化编排三个职责。

真正的危险不是“层数少”,而是业务规则绑定到了某一个入口。假设 HTTP Controller 判断“已发货不能取消”,后来又增加消息消费者处理自动取消。如果消费者直接调用同一个 Mapper,却没有复制完整判断,就可能写入 HTTP 路径永远不会产生的非法状态。

Controller 直接调用 Mapper 与正确分层的数据流对比

用代码观察同一规则如何分叉

下面的纯 Java 示例先模拟两个入口各自处理规则,再用仓储接口和应用服务收拢同一个取消用例。真实项目中,MapperOrderRepository 可以由 MyBatis Mapper 实现数据库访问。

java
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());
    }
}

预期输出

text
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 语句”。

怎样从直接调用改回来

重构时不必一次重写全部代码。先选择一条容易出错的业务链路,把规则集中起来:

  1. 从 Controller 中抽出一个应用用例,例如 CancelOrderApplicationService。
  2. 把状态合法性判断移到 Order.cancel() 等领域方法。
  3. 让应用服务通过仓储接口加载和保存聚合。
  4. 让 MyBatis Mapper 留在仓储实现内部。
  5. 让 Controller、定时任务和消息消费者都复用同一个应用用例。

分层的目的不是增加文件数量,而是让业务规则只有一个可信入口、让数据库访问可以替换、让不同适配器复用同一用例。只要 Controller 可以绕过领域规则直接改库,系统就仍然存在产生不一致状态的通道。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Controller 直接调 Mapper 为什么危险

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通