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

整理 DDD 分层代码评审清单

整理 DDD 分层代码评审清单

DDD 分层重构完成后,真正容易回退的不是目录结构,而是业务规则重新散落、跨层依赖反向生长、Repository 被当成 DAO 使用。本文把这些风险整理成一份可直接用于 Pull Request 的评审清单,帮助团队从代码依赖而不是文件位置判断分层是否成立。

学习目标

  • 从业务规则位置、依赖方向和跨层调用判断职责是否放对层
  • 检查 Repository、DTO 转换和技术框架依赖是否破坏领域边界
  • 使用一份可复用的清单完成订单模块的分层代码评审

先检查依赖方向

评审 DDD 分层代码时,不要先看包名是否漂亮,而要先看谁依赖谁。一个类即使位于 domain 目录,只要直接依赖数据库实体、Web DTO 或具体框架,它仍然没有形成独立的领域层。

通常可以把依赖方向理解为:接口适配层调用应用层,应用层组织领域对象完成用例,基础设施层实现内层定义的技术抽象。领域模型不应为了上层或外部技术而改变自身结构。

下面的代码就是典型警报。它是片段示例,依赖项目中已经存在的 JpaOrderRepository 定义,不能单独运行。

java
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 代码评审清单最终要回答的不是“目录是否符合模板”,而是“业务核心能否独立演进”。只要业务规则的位置清晰、依赖持续向内、技术实现可以替换,分层架构才真正产生了维护价值。

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

目录与阅读设置

阅读设置

17

记录一个想法

整理 DDD 分层代码评审清单

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

登录哪都通