架构与系统设计 / 系统课时
从业务事实识别领域事件
从业务事实识别领域事件
订单表发生变化,并不意味着应该向其他服务发布事件。本篇以订单确认为例,区分操作请求、技术动作与业务事实,最终得到一份语义明确、成立条件清楚、值得跨边界传播的事件定义。
学习目标
- 从业务结果中识别事件,而不是直接映射数据库操作。
- 说明候选事件的成立条件、事实所有者和传播范围。
- 用成功、拒绝和回滚场景检查事件定义。
先分清请求、技术动作与业务事实
领域事件表达已经发生、值得其他部分知晓的业务事实,通常用过去式命名。它回答“发生了什么”,不表达“请做什么”;事实也不随当前状态变化而被改写。([Microsoft Learn][1])
以订单确认为例,下面的名称均为本例自定义。
| 描述 | 性质 | 为什么不能混用 |
|---|---|---|
ConfirmOrder |
确认订单的命令 | 表达意图,可能被拒绝 |
OrderRowUpdated |
订单行更新的技术通知 | 不能区分确认、改地址或其他变化 |
OrderConfirmed |
订单已确认的业务事实 | 表达一个明确的业务结果 |
本例约定:“已确认”表示通过确认规则并确定确认金额,不表示已经付款、占用库存或发货。先明确这句话,再选择字段,避免消费者误解业务承诺。
沿着状态变化找到成立条件
先写原状态、必须满足的规则和成功结果。本例中,用户确认订单时,要求订单仍是草稿、商品数量有效、确认金额已确定;通过后,订单进入已确认状态。
字段变化只是线索。更重要的是业务人员是否认可发生了一次订单确认。如果只是修复错误数据,就不能不加判断地把相同字段变化解释成新的确认事实。
本例把数据库超时留给故障日志,因为超时不能证明业务拒绝。若客服需要跟进“订单确认被拒绝”,应另行定义其成立条件,不能把所有异常都包装成业务事件。
决定哪些事实需要对外传播
领域事件可以在本服务内部、事务提交前产生和处理;跨业务边界的事实通知通常称为集成事件。对外传播必须基于成功提交的事实,不能让消费者依赖随后可能回滚的状态。([Microsoft Learn][1])

评审时问三个问题:谁有权确认事实?其他业务据此作出什么决定?内部实现改变后,事实还能保持原义吗?本例由订单服务确认事实,通知服务据此通知用户;内部计算变化不必全部公开。
事件消费者自行决定如何响应。若发送方要求指定接收方完成某项动作,应表达为命令,不要用过去式名称掩盖指令关系。([martinfowler.com][2])
写成能被反例检验的事件契约
下面是对外消息的数据结构片段示例,需要项目发布逻辑填入标识和时间;它不是发布程序,也不是中间件规定的固定格式。
{
"eventType": "OrderConfirmed",
"eventId": "<ID>",
"occurredAt": "<TIME>",
"orderId": "<ID>",
"confirmedAmount": "128.00",
"currency": "CNY"
}预期结果:消费者能识别已确认的订单及确认金额。两个 <ID> 分别代表事件标识与订单标识,不要求相等;<TIME> 替换为带时区的事实发生时间。金额使用十进制字符串,本例 CNY 对应人民币元。
验证三个场景:确认成功并提交后,允许对外发布;规则拒绝或事务回滚时,不得发布确认成功事件;随后取消订单,应表达新的取消事实,而不是改写原确认事实。这是语义检查,不代表消息只会投递一次。
好的事件定义同时说清“发生了什么”和“没有承诺什么”。先确定成立条件与传播价值,再设计字段,避免把内部操作细节变成长期对外契约。