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

检查最终依赖方向是否正确

检查最终依赖方向是否正确

订单模块完成分层后,最后一步不是看目录名称是否整齐,而是确认源码依赖真的只向内收敛。本节用一张依赖图和一段可执行检查脚本,验证接口层、应用层、领域层与基础设施层没有出现反向引用。

学习目标

  • 能说清四层之间允许的源码依赖方向
  • 能识别“运行时会调用基础设施”与“编译期依赖基础设施”的区别
  • 能用自动检查发现常见的跨层反向引用

明确允许的静态依赖

以订单模块为例,推荐把依赖控制成下面的方向:接口层依赖应用层,应用层依赖领域层;基础设施层为了实现仓储、支付等端口,可以依赖应用层或领域层。领域层不依赖任何外层,应用层也不应直接依赖基础设施。

层 可以直接依赖 应避免直接依赖
接口层 应用层、接口层自己的 DTO 基础设施实现
应用层 领域层、应用层自己的端口 接口层、基础设施层
领域层 领域层自身、JDK 基础类型 接口层、应用层、基础设施层
基础设施层 应用层端口、领域层模型 接口层的 Controller/DTO

订单模块最终依赖方向

这里最容易误判的是基础设施层的位置。它通常在“外层”,但实现内层定义的接口,因此编译期依赖方向是基础设施指向应用层或领域层;运行时对象却可能由应用服务调用,这两种箭头不能混为一谈。

用脚本做一次快速验收

下面的 Bash 脚本假定包路径为 src/main/java/com/example/order/{interfaces,application,domain,infrastructure}。它检查三类关键倒挂:领域层引用外层、应用层引用接口或基础设施、接口层直接引用基础设施。

bash
#!/usr/bin/env bash
set -euo pipefail

ROOT="src/main/java/com/example/order"

for layer in interfaces application domain infrastructure; do
  if [[ ! -d "$ROOT/$layer" ]]; then
    echo "Missing layer directory: $ROOT/$layer" >&2
    exit 2
  fi
done

check_forbidden() {
  local dir="$1"
  local pattern="$2"

  if grep -R -n -E "$pattern" "$dir" --include='*.java'; then
    echo "Forbidden dependency found under $dir" >&2
    exit 1
  fi
}

check_forbidden "$ROOT/domain"   'import com\.example\.order\.(interfaces|application|infrastructure)\.'
check_forbidden "$ROOT/application"   'import com\.example\.order\.(interfaces|infrastructure)\.'
check_forbidden "$ROOT/interfaces"   'import com\.example\.order\.infrastructure\.'

echo "Dependency direction check passed."

预期输出

text
Dependency direction check passed.

如果检查失败,grep 会先打印违规文件和行号,再退出非零状态,适合直接接入 CI。这个脚本是源码级快速守门,只覆盖显式 import;如果项目大量使用全限定类名、反射或复杂模块边界,应再补充 ArchUnit、JPMS 或构建模块依赖检查。

区分对象装配与依赖倒挂

依赖注入经常让人误以为“应用层调用了基础设施,所以应用层一定依赖基础设施”。实际上,应用层只需要依赖自己定义的端口,外层在启动阶段把实现注入进去即可。

下面是片段示例,装配代码应位于模块启动或配置位置,而不是应用服务内部。

java
PaymentGateway gateway = new ThirdPartyPaymentGateway(providerSdk);
PayOrderService service = new PayOrderService(gateway);

PayOrderService 的源码类型只出现 PaymentGateway,因此依赖仍然朝向内层抽象;ThirdPartyPaymentGateway 反过来实现这个端口。真正需要禁止的是在应用层写 new ThirdPartyPaymentGateway(...),因为那会把具体实现重新拉回内层。

按症状检查常见倒挂

重构订单模块时,可以优先搜索几类高风险信号:Controller 直接调用数据库 Repository;应用服务直接创建支付厂商客户端;领域对象引用 Spring Data、HTTP 客户端或接口层 DTO;基础设施代码反过来接收 Controller 专用请求对象。

发现这类引用时,修复方式不是简单移动文件,而是重新定义边界:接口层负责协议 DTO 与应用命令之间的转换,应用层编排用例,领域层保存业务规则,基础设施层实现数据库、消息和第三方系统适配。

最终验收应同时满足两个条件:从源码看,领域层最稳定、没有向外依赖;从运行时看,接口请求仍能经过应用服务调用领域模型,并通过端口连接基础设施实现。目录结构、依赖方向和运行链路三者一致,分层才真正成立。

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

目录与阅读设置

阅读设置

17

记录一个想法

检查最终依赖方向是否正确

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

登录哪都通