架构与系统设计 / 系统课时
识别订单领域事件
识别订单领域事件
订单模型里的领域事件不是“调用了某个方法”,而是已经发生、值得被业务记住的事实。本节从创建、支付确认和取消三个场景出发,识别 OrderCreated、OrderCancelled 等事件,并把事件的命名、触发时机和最小载荷落到可执行的建模规则上。
学习目标
- 能从订单业务动作中识别真正有业务意义的领域事件
- 能确定事件应在聚合规则校验、状态变更和持久化流程中的触发位置
- 能为事件选择稳定名称和足够但不过量的数据载荷
从业务事实找事件
识别事件时,先把需求里的动词改写成“已经发生的事实”。“创建订单”是命令意图,成功之后的事实才是 OrderCreated;“取消订单”是请求,只有订单满足取消规则并真正进入取消状态后,才产生 OrderCancelled。
一个候选事实是否值得成为领域事件,可以连续问三个问题:业务人员会不会用过去时描述它;其他规则或模块是否需要知道它已经发生;即使当前没有消费者,这个事实是否仍是领域模型中重要的状态变化。三个问题都答不上来时,它更可能只是实现细节。
在订单练习中,可以先得到下面的候选事件:
| 业务动作 | 成功后的领域事实 | 不应产生事件的情况 |
|---|---|---|
| 创建订单 | OrderCreated |
商品、价格或地址校验失败,订单没有建立 |
| 确认支付 | OrderPaymentConfirmed |
支付通知重复且订单已经处理过 |
| 取消订单 | OrderCancelled |
订单状态不允许取消,取消请求被拒绝 |
确定事件的触发时机
领域事件应表示“状态变化已经成立”,因此不能在规则校验之前就创建。以取消订单为例,先读取订单当前状态并校验“是否允许取消”,再修改订单状态,随后记录 OrderCancelled。如果校验失败,既不改变聚合状态,也不产生成功事件。

这里要区分“产生事件”和“发布事件”。聚合可以在完成合法状态变更时把事件记录到待发布集合;应用层在事务提交成功后再把它交给消息机制。这样可以避免数据库回滚了,却已经让外部系统收到“订单已取消”的假事实。
设计最小而稳定的事件载荷
事件需要携带消费者判断业务事实所必需的数据,但不要把整个聚合序列化进去。过量字段会让事件与当前对象结构强耦合,后续模型演进时更难维护。
以 OrderCancelled 为例,常见的最小信息包括 orderId、cancelledAt、reason。如果下游只需要知道哪张订单已取消,就不必附带全部订单行、收货地址和价格明细。事件字段应围绕“发生了什么”设计,而不是围绕某个页面需要展示什么来设计。
事件名称也应采用过去时事实,而不是命令式名称。CancelOrder 适合表示请求,OrderCancelled 表示结果;SendCancellationEmail 则是后续动作,不是订单领域事实。
用消费方反查边界
事件设计完成后,再反过来检查谁会消费它。库存、营销、通知或分析模块如果都直接依赖订单内部对象结构,说明边界可能过紧;如果它们只依赖稳定的业务事实,订单聚合就能保持自己的职责。
还要警惕把所有技术动作都包装成领域事件。例如“RepositorySaved”“KafkaMessageSent”描述的是基础设施行为,不是订单业务事实。领域事件应该帮助模型表达业务变化,而不是记录程序执行轨迹。
最终可以用一句规则收束本节:先确认业务事实成立,再由聚合记录过去时事件;事件只携带稳定且必要的信息,外部发布则与事务成功保持一致。