架构与系统设计 / 系统课时
怎样发现错误的跨层依赖
怎样发现错误的跨层依赖
跨层依赖最危险的地方不是编译失败,而是代码依然能运行,却把职责和依赖方向悄悄打乱。本节给出一套可执行的检查顺序,用来识别 Controller 直连 Mapper、Domain 依赖 Infrastructure 等反向依赖,并判断应该把依赖移到哪里。
学习目标
- 根据分层职责判断一次依赖是否合法,而不是只看类名
- 识别 Controller 直连持久化、Domain 引用基础设施等典型违规
- 用源码扫描和依赖关系图快速定位需要重构的边界
先看依赖方向是否违反层次
DDD 分层架构的关键不是目录名称,而是依赖方向。常见约束可以简化为:接口层调用应用层,应用层协调领域对象,基础设施层实现领域或应用定义的端口;领域层不应该反向知道 Controller、数据库 Mapper、消息客户端等技术细节。

判断一条依赖时,可以问两个问题:当前类是在表达业务规则,还是在处理技术细节;被依赖对象如果更换技术实现,当前类是否应该跟着修改。若答案是“业务规则不该变,但现在必须改”,通常说明依赖方向已经反了。
识别最常见的违规形态
Controller 直连 Mapper 会绕过应用层。这样做短期代码少,但事务边界、权限校验、领域规则和用例编排会散落在接口层。Controller 更适合把请求转换成用例输入,再调用 Application Service 或 Command Handler。
Domain 依赖 Infrastructure 更严重。例如领域对象直接 import MyBatis Mapper、JPA Repository 实现、Redis 客户端或消息 SDK,会把业务规则绑定到技术方案。正确做法通常是在领域层或应用层定义抽象端口,由基础设施层实现。
Application 直接依赖 Web 类型 也值得警惕。应用服务如果接收 HttpServletRequest、返回 ResponseEntity,就把接口协议带进了用例层。应用层应使用自己的输入输出模型,让 Web 层负责转换。
用源码扫描做第一轮排查
下面的命令会创建一个最小示例并扫描两类反向依赖。脚本使用临时目录,不修改当前项目,用它可以先理解源码级检查的基本方法。
WORK_DIR=$(mktemp -d)
mkdir -p "$WORK_DIR/src/main/java/com/example/order/domain"
mkdir -p "$WORK_DIR/src/main/java/com/example/order/interfaces"
cat > "$WORK_DIR/src/main/java/com/example/order/domain/Order.java" <<'EOF'
package com.example.order.domain;
import com.example.order.infrastructure.persistence.OrderMapper;
public class Order {
}
EOF
cat > "$WORK_DIR/src/main/java/com/example/order/interfaces/OrderController.java" <<'EOF'
package com.example.order.interfaces;
import com.example.order.infrastructure.persistence.OrderMapper;
public class OrderController {
}
EOF
grep -RhE '^import .*[.]infrastructure[.]' "$WORK_DIR/src/main/java/com/example/order/domain" "$WORK_DIR/src/main/java/com/example/order/interfaces"预期输出
import com.example.order.infrastructure.persistence.OrderMapper;
import com.example.order.infrastructure.persistence.OrderMapper;这类扫描适合做“发现问题”的第一层过滤,但不能单独决定是否违规。真实项目里还要结合包职责判断,例如 Infrastructure 内部互相依赖通常合理,而 Domain 中引用 Infrastructure 基本就是强烈信号。
按调用链确认根因
发现可疑 import 后,不要立刻机械搬文件。先沿调用链确认谁在承担不属于自己的职责。以 Controller 直连 Mapper 为例,如果 Controller 同时做参数校验、查询、状态变更和事务控制,根因通常不是“import 写错”,而是缺少应用层用例边界。
修复时应把用例编排放入 Application,把业务判断留在 Domain,把数据库访问通过 Repository 或端口抽象隔离,再由 Infrastructure 提供实现。这样重构后,接口层只依赖应用层,领域层只保留业务概念,技术实现可以替换而不牵动核心模型。
把检查规则固化到代码评审
人工评审适合判断语义,自动化适合守住明显边界。可以在 CI 中加入 ArchUnit、模块化构建约束或静态扫描规则,禁止 domain 包引用 infrastructure,禁止 interfaces 直接引用 Mapper 实现。规则不需要覆盖所有设计问题,但应稳定拦住团队已经达成共识的反向依赖。
真正有效的跨层依赖检查,不是追求“零跨包调用”,而是保证依赖始终指向更稳定的业务抽象。看到一条可疑引用时,先判断职责,再确认依赖方向,最后才决定重构位置。