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

为什么领域层不能依赖基础设施层

为什么领域层不能依赖基础设施层

领域层一旦直接调用 MyBatis、Redis 客户端或第三方 SDK,业务规则就会和具体技术绑定。短期看少了一层接口,长期却会让技术替换、测试和模型演进都牵动核心代码。本节用依赖倒置把变化隔离在领域之外。

学习目标

  • 解释领域层直接依赖基础设施实现会带来的耦合
  • 理解“领域定义抽象、基础设施实现抽象”的依赖方向
  • 能用一个最小 Java 示例验证技术实现可替换而领域代码不变

直接依赖的问题不只是难测试

如果领域服务直接导入 MyBatis Mapper、Redis 客户端或支付 SDK,它就必须理解查询方式、缓存键、异常类型甚至连接行为。这样一来,数据库框架升级、缓存方案替换或第三方接口变化都会迫使业务代码跟着修改。

更重要的是,代码依赖方向被技术细节反客为主。领域层本应描述“需要什么业务能力”,例如读取信用额度、保存聚合或执行付款,而不是描述“通过什么框架完成”。前者稳定,后者通常更容易变化。

领域层直接依赖与依赖倒置对比

让领域层只依赖自己定义的抽象

下面的 Java 17 示例把“读取信用额度”定义成领域需要的接口。领域服务只认识这个接口;基础设施实现可以替换,而审批规则本身不需要改动。

java
import java.util.Map;

public class DependencyInversionDemo {
    interface CreditLimitRepository {
        int findLimitCents(String customerId);
    }

    static final class OrderApprovalService {
        private final CreditLimitRepository limits;

        OrderApprovalService(CreditLimitRepository limits) {
            this.limits = limits;
        }

        boolean approve(String customerId, int orderAmountCents) {
            return orderAmountCents <= limits.findLimitCents(customerId);
        }
    }

    static final class InMemoryCreditLimitRepository
            implements CreditLimitRepository {
        private final Map<String, Integer> data =
                Map.of("C-100", 20_000);

        public int findLimitCents(String customerId) {
            return data.getOrDefault(customerId, 0);
        }
    }

    public static void main(String[] args) {
        CreditLimitRepository repository =
                new InMemoryCreditLimitRepository();
        OrderApprovalService service =
                new OrderApprovalService(repository);

        System.out.println(service.approve("C-100", 12_000));
    }
}

预期输出

text
true

把 InMemoryCreditLimitRepository 换成基础设施层中的 MyBatis、Redis 或远程 API 适配器时,只要继续实现 CreditLimitRepository,OrderApprovalService 不需要知道底层技术发生了什么变化。示例中的内存实现也让领域规则可以在不启动数据库和缓存的情况下被验证。

MyBatis、Redis 和第三方 SDK 应该放在哪里

这些技术并不是“不能使用”,而是应当被限制在基础设施适配器中。MyBatis 实现仓储接口,Redis 可以实现缓存或读模型接口,第三方 SDK 可以被支付、消息或风控适配器包装。它们把技术异常、数据格式和调用细节转换成上层能够理解的结果。

应用层通常负责用例编排,并在组合根或依赖注入容器中把领域接口与基础设施实现连接起来。这样运行时调用仍会进入数据库或外部服务,但源码依赖保持为基础设施依赖领域抽象,而不是领域依赖具体框架。

判断依赖方向是否守住

检查代码时,可以从领域模块的导入和构建依赖入手。如果领域包出现 ORM 注解、Redis 客户端类型、HTTP SDK 请求对象或厂商异常类型,通常说明技术细节已经越过边界。更稳妥的做法是让领域暴露自己的接口和值对象,再由外层完成适配。

依赖倒置并不是为了多写接口,而是让最稳定、最有业务价值的代码处在依赖中心。技术实现可以按需要替换,领域规则仍保持可读、可测试,也不会因为某个框架升级就被迫一起迁移。

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

目录与阅读设置

阅读设置

17

记录一个想法

为什么领域层不能依赖基础设施层

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

登录哪都通