架构与系统设计 / 系统课时
整理 DDD 分层代码评审清单
整理 DDD 分层代码评审清单
DDD 分层重构完成后,真正容易回退的不是目录结构,而是业务规则重新散落、跨层依赖反向生长、Repository 被当成 DAO 使用。本文把这些风险整理成一份可直接用于 Pull Request 的评审清单,帮助团队从代码依赖而不是文件位置判断分层是否成立。
学习目标
- 从业务规则位置、依赖方向和跨层调用判断职责是否放对层
- 检查 Repository、DTO 转换和技术框架依赖是否破坏领域边界
- 使用一份可复用的清单完成订单模块的分层代码评审
先检查依赖方向
评审 DDD 分层代码时,不要先看包名是否漂亮,而要先看谁依赖谁。一个类即使位于 domain 目录,只要直接依赖数据库实体、Web DTO 或具体框架,它仍然没有形成独立的领域层。
通常可以把依赖方向理解为:接口适配层调用应用层,应用层组织领域对象完成用例,基础设施层实现内层定义的技术抽象。领域模型不应为了上层或外部技术而改变自身结构。
下面的代码就是典型警报。它是片段示例,依赖项目中已经存在的 JpaOrderRepository 定义,不能单独运行。
package com.example.order.application;
import com.example.order.infrastructure.persistence.JpaOrderRepository;
public final class CancelOrderService {
private final JpaOrderRepository orderRepository;
public CancelOrderService(JpaOrderRepository orderRepository) {
this.orderRepository = orderRepository;
}
}问题并不在类名,而在应用层直接认识了基础设施层的具体实现。更稳妥的做法是让应用服务依赖内层拥有的 OrderRepository 抽象,再由基础设施层提供实现。采用经典 DDD 时 Repository 接口常放在领域层;采用端口式架构时也可能放在应用层。评审重点不是目录教条,而是抽象由内层控制、技术实现向内适配。
检查业务规则放在哪里
订单模块最重要的一项检查,是业务规则有没有仍然藏在 Controller、Application Service、Mapper 或 Repository 实现中。
- ☐ 订单状态转换、金额约束、取消条件等领域规则由实体、值对象或领域服务表达。
- ☐ 应用服务主要负责加载对象、调用领域行为、保存结果和协调外部能力,没有重新实现一套业务判断。
- ☐ Controller 只处理协议输入、认证上下文和响应转换,不决定订单能不能取消、能不能支付。
- ☐ Repository 实现只负责持久化映射与读写,不因为数据库操作方便而承担业务决策。
看到应用服务里连续出现大量 if 判断时,应继续追问:这些条件是在描述业务事实,还是仅仅处理流程异常?前者通常应该回到领域模型,后者才更可能属于应用编排。
检查跨层调用和 Repository
跨层调用最容易把已经拆开的架构重新粘在一起。评审时应重点关注 import、构造器依赖和返回类型,而不是只检查调用链表面上能否运行。
- ☐ 领域层没有依赖应用层、接口适配层或基础设施层。
- ☐ 应用层没有直接实例化数据库客户端、ORM Repository、消息客户端等技术实现。
- ☐ 基础设施层可以依赖领域层或应用层定义的接口,以实现这些端口。
- ☐ Repository 接口表达聚合的获取和保存需求,而不是暴露 ORM 查询细节。
- ☐ Repository 方法没有随意返回数据库 Entity、分页框架类型或 ORM 专属对象给领域层。
- ☐ 一个聚合的持久化入口保持清晰,没有绕过聚合根直接修改内部实体而破坏不变量。
例如 findById、save 这类面向聚合的能力通常比把 EntityManager、JpaSpecificationExecutor 或数据库表结构直接暴露给内层更符合分层目的。
检查 DTO 与模型转换
DTO 的价值是隔离边界,而不是替代领域模型。Web 请求字段、消息结构和数据库字段都可能变化,如果这些结构直接进入领域对象,外部变化就会持续污染核心业务代码。
- ☐ Request DTO、Response DTO 没有进入领域层方法签名。
- ☐ 应用边界完成 DTO、命令对象与领域对象之间必要的转换。
- ☐ 持久化 Entity 与领域实体之间存在明确映射,没有因为字段相似就把两者合并。
- ☐ Mapper 只做结构转换,不偷偷查询数据库或执行价格计算、状态判断等业务规则。
- ☐ API 为展示增加的字段没有反向迫使领域模型保存纯展示数据。
如果一个 Mapper 已经需要注入 Repository、远程客户端或多个领域服务,它通常不再只是 Mapper,应重新判断其中是否混入了应用编排或业务规则。
检查技术依赖有没有渗入核心层
技术框架往往通过注解、异常类型和工具类悄悄进入领域代码。并不是任何注解都一定有问题,但评审者应确认领域模型是否因此失去了独立表达业务的能力。
重点检查领域层是否直接出现 ORM Entity、HTTP 请求对象、消息中间件类型、数据库驱动类型以及只为框架服务的基类。应用层也应避免依赖具体数据库或消息实现,而通过抽象表达“保存订单”“发布事件”等需要。
Pull Request 最终检查单
提交订单模块重构前,可以用下面这组问题做最后检查:
- ☐ 核心业务规则能够从领域模型中直接找到,而不是散落在外围层。
- ☐ Controller、应用服务、领域对象和基础设施实现各自承担单一职责。
- ☐ 所有跨层依赖方向都指向更稳定的业务抽象,没有内层反向依赖外层实现。
- ☐ Repository 抽象与具体持久化实现已经分离,接口没有泄漏 ORM 或数据库细节。
- ☐ DTO、持久化 Entity 与领域模型边界清楚,转换代码没有承载业务决策。
- ☐ 领域层不存在非必要的 Web、数据库、消息或框架技术依赖。
- ☐ 新增功能可以主要通过组合应用服务和领域行为完成,而不需要修改多个外围层才能加入一条业务规则。
一份有效的 DDD 代码评审清单最终要回答的不是“目录是否符合模板”,而是“业务核心能否独立演进”。只要业务规则的位置清晰、依赖持续向内、技术实现可以替换,分层架构才真正产生了维护价值。