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

领域层为什么不应该依赖 Spring

领域层为什么不应该依赖 Spring

领域层负责表达业务规则,而 Spring、数据库和 HTTP 类型负责运行环境与技术接入。把这些技术细节直接塞进实体和值对象,会让业务模型只能在特定框架中运行,也让单元测试、迁移和复用都变得更困难。

学习目标

  • 识别领域模型对 Spring、数据库和 HTTP 类型的反向依赖
  • 理解“领域层定义规则、外围层负责适配”的依赖方向
  • 用纯 Java 领域对象保持模型独立且易测试

领域层应该依赖什么

理想的领域对象主要依赖语言本身、领域值对象,以及少量由领域层自己定义的抽象。实体是否允许取消、金额如何计算、状态怎样转换,这些规则不需要知道请求来自 HTTP,也不需要知道最终保存到 MySQL、MongoDB 还是内存。

一旦领域对象大量出现 @Service、@Autowired、HttpServletRequest、持久化实现类或数据库连接对象,业务代码就开始依赖技术环境。此时测试一个简单规则,可能也必须启动 Spring 容器或准备数据库。

领域层与外围依赖方向

技术类型进入领域模型会带来什么

最直接的问题是可测试性下降。假设一个订单取消规则只是检查状态,却因为实体依赖 Spring Bean 才能工作,那么验证规则就不再是普通对象测试,而变成框架集成测试。测试更慢,失败原因也更复杂。

第二个问题是模型语义被污染。HttpServletRequest 表示传输协议,数据库访问 API 描述持久化机制,它们都不是“订单为什么能取消”的业务概念。技术细节越多,读代码时越难看出真正的业务规则。

第三个问题是替换成本上升。迁移 Web 框架、数据库或消息组件时,如果领域层直接引用这些 API,改动会沿依赖链进入核心模型;如果技术细节停留在适配层,领域规则通常可以保持不变。

保持领域对象为纯 Java

下面的示例不启动 Spring,也不访问数据库,直接验证订单的业务行为:

java
public class DomainIndependenceDemo {
    enum OrderStatus {
        CREATED, PAID, CANCELLED
    }

    static final class Order {
        private OrderStatus status;

        Order(OrderStatus status) {
            this.status = status;
        }

        void cancel() {
            if (status == OrderStatus.PAID) {
                throw new IllegalStateException("paid order cannot be cancelled");
            }
            status = OrderStatus.CANCELLED;
        }

        OrderStatus status() {
            return status;
        }
    }

    public static void main(String[] args) {
        Order order = new Order(OrderStatus.CREATED);
        order.cancel();
        System.out.println(order.status());
    }
}

预期输出:

text
CANCELLED

这里的 Order 只描述状态和取消规则。它不知道谁调用自己,也不知道状态最终存在哪里,因此可以在普通 JVM 中快速验证。

Spring 应该出现在哪里

Spring 很适合放在应用层和基础设施层,用来组装对象、开启事务、实现仓储、接收 HTTP 请求或发布消息。关键不是“项目里不能用 Spring”,而是让框架依赖停留在核心模型之外。

常见做法是由领域层定义 OrderRepository 这样的仓储接口,基础设施层再使用 Spring Data JPA、JDBC 或其他技术实现它。应用服务依赖领域接口,Spring 负责在运行时把具体实现装配进去。这样依赖方向是“基础设施依赖领域契约”,而不是“领域依赖数据库框架”。

验证边界时,可以先在不启动 Spring 的单元测试中测试领域规则;只有仓储实现、事务配置和 HTTP 适配等技术部分需要进入 Spring 集成测试。测试层次因此与架构边界保持一致。

不是所有注解都必须绝对禁止

实际项目中,有些团队会在实体上保留少量 JPA 注解,以换取开发效率。是否接受这种折中取决于团队对框架耦合、持久化复杂度和测试策略的权衡。需要警惕的不是某个注解本身,而是领域规则是否开始依赖容器生命周期、数据库会话、HTTP 上下文或框架回调才能成立。

最实用的边界检查是:把领域代码单独放进一个不依赖 Spring 的模块后,核心业务规则是否仍能编译并执行。如果答案是肯定的,技术框架就在为领域模型服务;如果答案是否定的,就应该继续检查哪些技术类型或生命周期已经侵入核心。

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

目录与阅读设置

阅读设置

17

记录一个想法

领域层为什么不应该依赖 Spring

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

登录哪都通