DDD 模型详细说明
DDD 的模型不是数据库模型的换名,也不是把对象分成几种类型后放进不同包里。它是一套从业务现场提炼出来的表达方式:哪些词在同一个语境里成立,哪些对象有身份,哪些描述可以当作值,哪些规则必须同时满足,哪些事实发生后要通知其他边界。
下面用“下单预占库存,支付后确认扣减并安排发货”这条业务线贯穿说明。这是本例的业务策略,并非所有行业的固定顺序:预售可以延后分配库存,现货交易则可能要求付款前预占。先确定库存不足和支付迟到的处理规则,再选择事件顺序。
统一语言
统一语言是 DDD 的入口。它不是写一份词汇表放在文档里,而是让需求讨论、代码命名、接口字段、事件名称使用同一套业务词汇。业务说“订单已支付”,代码里就应能看到 OrderPaid、markPaid、paidAt 这样的表达,而不是只看到 status = 2。
统一语言要跟着上下文走。同一个“客户”在会员上下文里强调账号、等级和联系方式;在订单上下文里强调购买人和收货信息;在风控上下文里强调风险标签和行为轨迹。强行把这些含义塞进一个全局 Customer,会让对象越来越胖,也会让每个团队都害怕改它。
可落地的做法是把核心词汇写进代码和测试。需求评审中发现新词时,先确认它是否已有概念;同词不同义时,要给它划上下文;一个字段名需要额外注释才能解释业务含义时,优先修改命名或模型,而不是继续补注释。
子域和限界上下文
子域描述业务版图,限界上下文描述模型边界。子域更像业务地图,告诉团队哪些部分是核心竞争力,哪些只是支撑能力;限界上下文更像模型围栏,告诉代码里某个词在哪个范围内有明确含义。
在一般零售业务中,交易可能是核心域,短信发送可采用通用方案;以仓储效率竞争的企业,库存和履约反而可能是核心能力。分类取决于竞争策略和投入重点,不按名词固定。进入模型设计时,可以形成订单、库存、支付、履约等上下文;子域与上下文并非必须一一对应,也不必一开始就是独立微服务,但要能说明语言和规则边界。
边界划分要看业务规则是否独立变化。订单状态机经常和支付、取消、售后相关;库存规则关心占用、释放、盘点、仓库批次;支付规则关心渠道、流水、退款和对账。如果这些规则变化节奏不同,模型也不应绑在一起。边界不是为了隔离团队,而是为了让每个模型在自己的语境里保持干净。
实体和值对象
实体有身份。订单从创建、支付、发货到完成,金额、状态、收货地址会不断变化,但订单号标识的仍是同一个订单。支付单、库存记录、会员账户也属于实体,因为它们有生命周期,业务会追踪“这一个对象”发生了什么变化。
值对象没有独立身份,它表达一组不可拆开的描述。金额由数值和币种组成,地址由省市区、详细地址、收件人和手机号组成,时间范围由开始和结束时间组成。业务比较它们时看值是否相等,而不是看它们是不是同一个对象。值对象应设计为不可变,修改地址时创建一个新地址,而不是在原对象上随意改字段。
一个实用判断是:业务会不会追问“是哪一个”。如果会追问“是哪一个订单”“是哪一笔支付流水”,多半是实体;如果只关心“金额是否相同”“地址是否相同”“时间段是否重叠”,更适合值对象。值对象能把校验收拢起来,例如币种不能为空、时间范围结束不能早于开始。订单应付金额通常非负,但会计调整额可以有负数;约束由具体概念决定,不能让通用 Money 替所有金额作决定。
聚合和聚合根
聚合是一致性边界,不是对象集合的美化名称。它回答的是:哪些对象必须一起修改,才能保证业务规则不被破坏。聚合根是这道边界的门,外部只能通过它改变内部状态。
订单聚合可以包含订单项和订单金额,因为“订单总金额等于订单项小计之和”“已支付订单不能随意增删订单项”这些规则需要在订单内部同时成立。外部代码不应该直接修改订单项数量,而应该调用订单聚合根的行为,例如 changeItemQuantity,由订单自己重新计算金额并检查状态。
库存记录不应直接放进订单聚合。本例下单时预占库存,接受支付后通过事件要求库存确认扣减;关闭订单时要求释放预占。库存上下文检查预占标识与状态,防止同一份库存既扣减又释放。若支付成功但预占已经过期,流程管理器需要核对或退款,不能靠订单聚合强行修复库存对象。
聚合大小要围绕不变量判断。需要同一事务内严格成立的规则放进一个聚合;只需要流程协作或最终一致的规则,交给应用层编排、领域事件或流程管理器。聚合太大,保存一次订单会拖着库存、支付、履约一起更新;聚合太小,业务规则会散在外部服务里。设计时要不断追问:这条规则如果延迟几秒成立,业务是否还能接受;这条规则如果失败,能否补偿。
领域服务、应用服务和仓储
领域服务承载纯业务规则,应用服务编排用例流程,仓储负责保存和取回聚合。三者混在一起时,代码会变成事务脚本:接口进来后查库、判断、改字段、发消息,业务含义藏在一长串过程里。
应用服务适合处理“核验支付事实、加载订单、调用领域行为、可靠提交结果”这样的流程。它定义鉴权和事务入口,但不把“订单能否接受支付”“金额是否匹配”“状态能否流转”复制成多套判断。规则回到订单、金额、库存策略或领域服务中。远程扣款不能通过本地数据库回滚撤销,需要支付单、幂等键和渠道查询单独管理结果未知的状态。
领域服务适合处理跨多个领域对象但仍属于领域规则的行为。例如定价需要同时读取会员等级、商品促销、优惠券规则,但结果是“本次订单的应付金额”。如果把它放进订单实体,订单会知道太多外部规则;如果放进应用服务,业务计算会失去模型位置。此时可以建立定价领域服务,让它专注表达定价规则。
仓储看起来像数据访问对象,但目标不同。仓储以聚合为单位提供保存和查询能力,例如 OrderRepository.findById(orderId)、save(order)。领域层定义仓储接口,基础设施层实现数据库、缓存和 ORM 细节。这样订单模型可以在不连接数据库的情况下进行单元测试。
领域事件
领域事件表达已经发生的业务事实。它的名字使用过去式,例如 OrderCreated、OrderPaid、StockLocked、ShipmentCreated。事件不是命令,不能用 LockStock 表示“请去锁库存”;那是一个动作请求,不是事实。
事件的价值在于切开边界协作。订单完成支付后,库存、积分、消息通知、履约都会关心这个事实,但订单不应该知道所有后续动作。订单只发布“订单已支付”,其他上下文根据自己的职责订阅和处理。这样新增“支付后发放会员积分”时,不需要把积分逻辑塞回订单聚合。
领域事件也要有边界意识。并不是所有字段变化都需要事件,只有业务上值得被其他模型感知的事实才适合沉淀为事件。事件内容也不应暴露内部对象结构,应包含业务标识、发生时间、关键结果和必要的快照数据。跨上下文事件一旦发布,就会成为协作契约,命名和字段要比内部方法更慎重。
代码结构示例
DDD 不要求固定目录。采用领域模型与基础设施隔离的方式时,业务规则不依赖具体数据库、消息队列和 HTTP 客户端,应用层编排用例,基础设施实现技术接口。ORM 映射可使用独立持久化对象,也可以在不改变业务含义的前提下使用少量注解;要防止会话、懒加载和数据库操作成为领域行为的隐式前提。一个订单模块可以按下面方式组织:
text
order/
├── interfaces/
│ └── OrderController.java
├── application/
│ ├── AcceptPaymentCommand.java
│ └── OrderApplicationService.java
├── domain/
│ ├── Order.java
│ ├── OrderLine.java
│ ├── Money.java
│ ├── OrderRepository.java
│ ├── PricingService.java
│ └── event/
│ └── OrderPaid.java
└── infrastructure/
├── JpaOrderRepository.java
└── OutboxRelay.java下面是提交职责的机制片段,省略了接口定义、鉴权和重试框架。payment 必须来自服务端完成验签、商户和交易核对的适配器,不能直接信任请求体;事务必须覆盖订单、Outbox 和核对任务所在的同一数据库:
java
public void acceptPayment(VerifiedPayment payment) {
transactions.required(() -> {
Order order = orderRepository.findById(payment.orderId());
PaymentDecision decision = order.acceptPayment(payment);
switch (decision) {
case APPLIED -> {
orderRepository.saveIfVersionMatches(order);
outbox.append(order.pullDomainEvents());
}
case ALREADY_APPLIED -> { }
case REJECT, NEEDS_RECONCILIATION ->
reconciliation.record(payment, decision);
}
});
}聚合表达能否接受、是否重复和是否需要核对;仓储用版本条件防止并发覆盖。版本冲突时整笔事务回滚,重新加载后再次判断,不能继续使用已修改的旧实例。核对任务按支付流水去重,订单不存在时也要进入可追踪的核对路径。提交成功后才能向回调方确认已接收。
独立投递器发送已提交的 Outbox,确认丢失可能重发;消费者把去重与业务效果一起提交。领域模型中产生事件,并不等于已经可靠发送了集成消息。完整的事务、关闭竞争与失败验收见 实践指南。
建模检查
检查一个 DDD 模型,可以从代码里找证据。核心业务词汇是否能直接出现;实体是否有业务行为,而不是只有属性;值对象是否收拢了校验和比较;聚合根是否控制内部对象修改;跨上下文协作是否通过清晰接口或领域事件完成;基础设施对象是否没有侵入领域层。
更重要的是看模型是否能解释变更。新增“部分发货”时,应能定位履约与订单的状态契约;将预占改成支付后分配库存时,应同时修改缺货补偿和超时规则;新增“企业客户月结”时,应区分支付与结算。规则放在哪里、哪个提交边界保护它、失败如何恢复,都应能从代码和验证结果中找到证据。
