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

识别订单领域事件

识别订单领域事件

订单模型里的领域事件不是“调用了某个方法”,而是已经发生、值得被业务记住的事实。本节从创建、支付确认和取消三个场景出发,识别 OrderCreated、OrderCancelled 等事件,并把事件的命名、触发时机和最小载荷落到可执行的建模规则上。

学习目标

  • 能从订单业务动作中识别真正有业务意义的领域事件
  • 能确定事件应在聚合规则校验、状态变更和持久化流程中的触发位置
  • 能为事件选择稳定名称和足够但不过量的数据载荷

从业务事实找事件

识别事件时,先把需求里的动词改写成“已经发生的事实”。“创建订单”是命令意图,成功之后的事实才是 OrderCreated;“取消订单”是请求,只有订单满足取消规则并真正进入取消状态后,才产生 OrderCancelled。

一个候选事实是否值得成为领域事件,可以连续问三个问题:业务人员会不会用过去时描述它;其他规则或模块是否需要知道它已经发生;即使当前没有消费者,这个事实是否仍是领域模型中重要的状态变化。三个问题都答不上来时,它更可能只是实现细节。

在订单练习中,可以先得到下面的候选事件:

业务动作 成功后的领域事实 不应产生事件的情况
创建订单 OrderCreated 商品、价格或地址校验失败,订单没有建立
确认支付 OrderPaymentConfirmed 支付通知重复且订单已经处理过
取消订单 OrderCancelled 订单状态不允许取消,取消请求被拒绝

确定事件的触发时机

领域事件应表示“状态变化已经成立”,因此不能在规则校验之前就创建。以取消订单为例,先读取订单当前状态并校验“是否允许取消”,再修改订单状态,随后记录 OrderCancelled。如果校验失败,既不改变聚合状态,也不产生成功事件。

订单领域事件的触发时机

这里要区分“产生事件”和“发布事件”。聚合可以在完成合法状态变更时把事件记录到待发布集合;应用层在事务提交成功后再把它交给消息机制。这样可以避免数据库回滚了,却已经让外部系统收到“订单已取消”的假事实。

设计最小而稳定的事件载荷

事件需要携带消费者判断业务事实所必需的数据,但不要把整个聚合序列化进去。过量字段会让事件与当前对象结构强耦合,后续模型演进时更难维护。

以 OrderCancelled 为例,常见的最小信息包括 orderId、cancelledAt、reason。如果下游只需要知道哪张订单已取消,就不必附带全部订单行、收货地址和价格明细。事件字段应围绕“发生了什么”设计,而不是围绕某个页面需要展示什么来设计。

事件名称也应采用过去时事实,而不是命令式名称。CancelOrder 适合表示请求,OrderCancelled 表示结果;SendCancellationEmail 则是后续动作,不是订单领域事实。

用消费方反查边界

事件设计完成后,再反过来检查谁会消费它。库存、营销、通知或分析模块如果都直接依赖订单内部对象结构,说明边界可能过紧;如果它们只依赖稳定的业务事实,订单聚合就能保持自己的职责。

还要警惕把所有技术动作都包装成领域事件。例如“RepositorySaved”“KafkaMessageSent”描述的是基础设施行为,不是订单业务事实。领域事件应该帮助模型表达业务变化,而不是记录程序执行轨迹。

最终可以用一句规则收束本节:先确认业务事实成立,再由聚合记录过去时事件;事件只携带稳定且必要的信息,外部发布则与事务成功保持一致。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别订单领域事件

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

登录哪都通