架构与系统设计 / 系统课时
领域事件应该怎样命名
领域事件应该怎样命名
领域事件的名字不是给技术实现贴标签,而是要让业务人员一眼看出“什么事实已经发生”。命名准确后,时间线更容易讨论,后续识别命令、规则和聚合边界时也不容易被含糊词语带偏。
学习目标
- 用已经发生的业务事实命名领域事件
- 区分业务事件与操作、接口调用、技术日志等实现细节
- 通过时间线语境检查事件名称的粒度和含义
把事件写成已经发生的事实
领域事件描述的是过去已经成立、且业务关心的事实,因此名称应该让人读到后自然产生“这件事已经发生了”的理解。例如订单流程中,可以使用「订单已创建」「库存已锁定」「支付已完成」「订单已取消」。
这种命名方式比「创建订单」「锁定库存」更适合作为事件。后两者更像要执行的动作,也就是命令;而事件应表达动作执行后留下的业务事实。
| 不推荐的名称 | 问题 | 更合适的事件名 |
|---|---|---|
| 创建订单 | 像命令或操作 | 订单已创建 |
| 锁库存 | 像待执行动作,且业务含义不完整 | 库存已锁定 |
| 支付接口成功 | 暴露技术实现 | 支付已完成 |
| 更新状态 | 没有说明哪个业务事实发生变化 | 订单已取消、退款已批准等 |
中文没有严格的语法时态,因此不要求所有事件机械地带一个「已」字。关键是名称必须表达确定发生的结果,例如「会员到期」「包裹签收」同样可以是清楚的业务事实。
使用业务语言而不是技术动作
事件风暴的目标是发现业务模型。如果事件名大量出现「写数据库」「调用接口」「发送 MQ」「更新字段」,讨论很快会滑向实现方案,而不是业务规则。
例如支付服务收到渠道回调后,技术上可能经历验签、更新记录和发布消息。但领域时间线上真正值得记录的通常是「支付已完成」或「支付已失败」,因为后续发货、通知、对账等业务决策关心的是支付事实,而不是哪一个接口被调用。
保持主语和粒度稳定
一个好的事件名通常能回答两个问题:哪个业务对象发生了变化,以及变化后的事实是什么。因此「订单已取消」比「已取消」清楚,「退款已批准」也比「审核完成」更容易放回业务上下文。
粒度还要与当前讨论范围一致。假设一次支付完成后,系统同时记录流水、增加积分并发送通知。如果当前讨论的是订单履约,「支付已完成」通常已经足够;如果正在建模会员积分,则「积分已入账」可能需要成为另一个独立事件。
不要为了显得详细,把一个业务事实拆成大量技术步骤;也不要把多个会触发不同后续规则的事实压成「订单已处理」这样的笼统事件。判断标准不是名称长短,而是后续业务是否需要分别对这些事实作出反应。
用几个问题检查事件名称
完成候选事件命名后,可以逐个检查:
- 读出名称时,它听起来是不是一个已经发生的事实?
- 业务人员是否理解这个名称,而不需要知道数据库、接口或消息中间件?
- 名称是否指出了具体业务对象和有意义的状态变化?
- 这个事实发生后,其他角色或规则是否可能据此采取行动?
- 把事件放回时间线后,前后关系是否仍然自然?
例如「处理退款」在第一项就会暴露问题,因为它仍像一个动作。进一步询问业务结果后,可能得到「退款申请已提交」「退款已批准」「退款已完成」三个不同事件。它们发生在不同时间,也可能分别触发审核、资金退回和用户通知,因此不能简单合并。
回到时间线验证命名
单独看一个名字可能觉得合理,放回时间线后问题会更明显。假设事件顺序是「订单已创建 → 库存已锁定 → 支付已完成 → 订单已发货」,每一项都表达明确的业务事实,也能自然回答“接下来发生什么”。
如果其中出现「调用支付接口」或「修改订单状态」,时间线就混入了动作和实现细节。此时应继续追问动作产生了什么业务结果,再把结果改写成领域事件。稳定的命名方式能让整条时间线保持在业务事实层面,也为后续发现触发这些事件的命令和业务规则留下清晰边界。