架构与系统设计 / 系统课时
检查最终依赖方向是否正确
检查最终依赖方向是否正确
订单模块完成分层后,最后一步不是看目录名称是否整齐,而是确认源码依赖真的只向内收敛。本节用一张依赖图和一段可执行检查脚本,验证接口层、应用层、领域层与基础设施层没有出现反向引用。
学习目标
- 能说清四层之间允许的源码依赖方向
- 能识别“运行时会调用基础设施”与“编译期依赖基础设施”的区别
- 能用自动检查发现常见的跨层反向引用
明确允许的静态依赖
以订单模块为例,推荐把依赖控制成下面的方向:接口层依赖应用层,应用层依赖领域层;基础设施层为了实现仓储、支付等端口,可以依赖应用层或领域层。领域层不依赖任何外层,应用层也不应直接依赖基础设施。
| 层 | 可以直接依赖 | 应避免直接依赖 |
|---|---|---|
| 接口层 | 应用层、接口层自己的 DTO | 基础设施实现 |
| 应用层 | 领域层、应用层自己的端口 | 接口层、基础设施层 |
| 领域层 | 领域层自身、JDK 基础类型 | 接口层、应用层、基础设施层 |
| 基础设施层 | 应用层端口、领域层模型 | 接口层的 Controller/DTO |

这里最容易误判的是基础设施层的位置。它通常在“外层”,但实现内层定义的接口,因此编译期依赖方向是基础设施指向应用层或领域层;运行时对象却可能由应用服务调用,这两种箭头不能混为一谈。
用脚本做一次快速验收
下面的 Bash 脚本假定包路径为 src/main/java/com/example/order/{interfaces,application,domain,infrastructure}。它检查三类关键倒挂:领域层引用外层、应用层引用接口或基础设施、接口层直接引用基础设施。
#!/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."预期输出
Dependency direction check passed.如果检查失败,grep 会先打印违规文件和行号,再退出非零状态,适合直接接入 CI。这个脚本是源码级快速守门,只覆盖显式 import;如果项目大量使用全限定类名、反射或复杂模块边界,应再补充 ArchUnit、JPMS 或构建模块依赖检查。
区分对象装配与依赖倒挂
依赖注入经常让人误以为“应用层调用了基础设施,所以应用层一定依赖基础设施”。实际上,应用层只需要依赖自己定义的端口,外层在启动阶段把实现注入进去即可。
下面是片段示例,装配代码应位于模块启动或配置位置,而不是应用服务内部。
PaymentGateway gateway = new ThirdPartyPaymentGateway(providerSdk);
PayOrderService service = new PayOrderService(gateway);PayOrderService 的源码类型只出现 PaymentGateway,因此依赖仍然朝向内层抽象;ThirdPartyPaymentGateway 反过来实现这个端口。真正需要禁止的是在应用层写 new ThirdPartyPaymentGateway(...),因为那会把具体实现重新拉回内层。
按症状检查常见倒挂
重构订单模块时,可以优先搜索几类高风险信号:Controller 直接调用数据库 Repository;应用服务直接创建支付厂商客户端;领域对象引用 Spring Data、HTTP 客户端或接口层 DTO;基础设施代码反过来接收 Controller 专用请求对象。
发现这类引用时,修复方式不是简单移动文件,而是重新定义边界:接口层负责协议 DTO 与应用命令之间的转换,应用层编排用例,领域层保存业务规则,基础设施层实现数据库、消息和第三方系统适配。
最终验收应同时满足两个条件:从源码看,领域层最稳定、没有向外依赖;从运行时看,接口请求仍能经过应用服务调用领域模型,并通过端口连接基础设施实现。目录结构、依赖方向和运行链路三者一致,分层才真正成立。