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

领域事件应该怎样命名

领域事件应该怎样命名

领域事件的名字不是给技术实现贴标签,而是要让业务人员一眼看出“什么事实已经发生”。命名准确后,时间线更容易讨论,后续识别命令、规则和聚合边界时也不容易被含糊词语带偏。

学习目标

  • 用已经发生的业务事实命名领域事件
  • 区分业务事件与操作、接口调用、技术日志等实现细节
  • 通过时间线语境检查事件名称的粒度和含义

把事件写成已经发生的事实

领域事件描述的是过去已经成立、且业务关心的事实,因此名称应该让人读到后自然产生“这件事已经发生了”的理解。例如订单流程中,可以使用「订单已创建」「库存已锁定」「支付已完成」「订单已取消」。

这种命名方式比「创建订单」「锁定库存」更适合作为事件。后两者更像要执行的动作,也就是命令;而事件应表达动作执行后留下的业务事实。

不推荐的名称 问题 更合适的事件名
创建订单 像命令或操作 订单已创建
锁库存 像待执行动作,且业务含义不完整 库存已锁定
支付接口成功 暴露技术实现 支付已完成
更新状态 没有说明哪个业务事实发生变化 订单已取消、退款已批准等

中文没有严格的语法时态,因此不要求所有事件机械地带一个「已」字。关键是名称必须表达确定发生的结果,例如「会员到期」「包裹签收」同样可以是清楚的业务事实。

使用业务语言而不是技术动作

事件风暴的目标是发现业务模型。如果事件名大量出现「写数据库」「调用接口」「发送 MQ」「更新字段」,讨论很快会滑向实现方案,而不是业务规则。

例如支付服务收到渠道回调后,技术上可能经历验签、更新记录和发布消息。但领域时间线上真正值得记录的通常是「支付已完成」或「支付已失败」,因为后续发货、通知、对账等业务决策关心的是支付事实,而不是哪一个接口被调用。

保持主语和粒度稳定

一个好的事件名通常能回答两个问题:哪个业务对象发生了变化,以及变化后的事实是什么。因此「订单已取消」比「已取消」清楚,「退款已批准」也比「审核完成」更容易放回业务上下文。

粒度还要与当前讨论范围一致。假设一次支付完成后,系统同时记录流水、增加积分并发送通知。如果当前讨论的是订单履约,「支付已完成」通常已经足够;如果正在建模会员积分,则「积分已入账」可能需要成为另一个独立事件。

不要为了显得详细,把一个业务事实拆成大量技术步骤;也不要把多个会触发不同后续规则的事实压成「订单已处理」这样的笼统事件。判断标准不是名称长短,而是后续业务是否需要分别对这些事实作出反应。

用几个问题检查事件名称

完成候选事件命名后,可以逐个检查:

  1. 读出名称时,它听起来是不是一个已经发生的事实?
  2. 业务人员是否理解这个名称,而不需要知道数据库、接口或消息中间件?
  3. 名称是否指出了具体业务对象和有意义的状态变化?
  4. 这个事实发生后,其他角色或规则是否可能据此采取行动?
  5. 把事件放回时间线后,前后关系是否仍然自然?

例如「处理退款」在第一项就会暴露问题,因为它仍像一个动作。进一步询问业务结果后,可能得到「退款申请已提交」「退款已批准」「退款已完成」三个不同事件。它们发生在不同时间,也可能分别触发审核、资金退回和用户通知,因此不能简单合并。

回到时间线验证命名

单独看一个名字可能觉得合理,放回时间线后问题会更明显。假设事件顺序是「订单已创建 → 库存已锁定 → 支付已完成 → 订单已发货」,每一项都表达明确的业务事实,也能自然回答“接下来发生什么”。

如果其中出现「调用支付接口」或「修改订单状态」,时间线就混入了动作和实现细节。此时应继续追问动作产生了什么业务结果,再把结果改写成领域事件。稳定的命名方式能让整条时间线保持在业务事实层面,也为后续发现触发这些事件的命令和业务规则留下清晰边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

领域事件应该怎样命名

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

登录哪都通