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

领域事件里应该放多少数据

领域事件里应该放多少数据

领域事件既不能只留下一个模糊的“发生了某事”,也不适合把整个聚合完整复制进去。真正需要的是一份足以描述当时业务事实、又不会把消费者绑死在聚合内部结构上的稳定数据契约。

学习目标

  • 判断领域事件中哪些数据属于事实本身,哪些只是当前对象结构
  • 在“只有 ID”和“复制整个聚合”之间选择合适的数据边界
  • 理解事件数据对历史还原、消费者耦合和版本演进的影响

先问事件要证明什么事实

设计事件字段时,不要从“聚合里有哪些属性”开始,而要先问:这个事件要证明什么已经发生的业务事实。以 OrderPaid 为例,事实不是“某个订单对象被修改了”,而是“某笔订单在某个时间以某个金额完成了支付”。

因此,事件通常需要包含能够唯一识别事实并解释事实含义的数据,例如 orderId、paymentId、amount、currency、paidAt。这些值即使聚合以后继续变化,仍然应该保持事件发生时的历史含义。

如果事件只有 orderId,消费者为了知道支付金额和时间,就必须再次查询订单。查询到的却可能是事件发生后的新状态,甚至目标数据已经被修改或删除,这会削弱事件作为历史事实的价值。

不要把整个聚合当成事件载荷

另一个极端是直接序列化整个 Order 聚合。这样看似省事,却会把内部模型结构公开给所有消费者。聚合新增字段、调整嵌套对象或重构值对象时,事件契约也被迫变化,原本独立的消费者因此与领域内部实现耦合。

更稳妥的做法是只放“解释本次事实所必需”的字段。可以用下面的判断方式筛选:

数据类型 是否通常应放入事件 原因
事实身份,如 orderId、paymentId 是 用于识别这次业务事实
事实发生时的关键业务值,如金额、币种 是 后续状态变化后仍需保留历史含义
发生时间,如 paidAt 通常是 事件顺序、审计和统计常需要
聚合的全部字段 通常否 容易把消费者绑定到内部结构
可随时从稳定主数据查询的展示字段 视场景而定 需要权衡一致性与冗余
密码、令牌等敏感数据 否 不应扩散到事件链路

事件不是聚合快照。除非业务明确需要“当时完整快照”这一语义,否则不要因为字段现成就全部复制。

ID 引用和事实快照要有意识地选择

某些字段只保存 ID 就足够。例如 customerId 如果只是后续流程定位客户的引用,可以不把客户姓名、电话和地址一起放进事件。消费者需要最新客户资料时,可以再查询客户服务。

但如果某个值本身就是事件事实的一部分,就不应只依赖后续查询。比如支付完成时的 amount 和 currency 决定了“支付了多少”这一事实;只保存 paymentId,再去读取支付记录,会让历史语义依赖外部数据始终不变。

判断标准可以概括为:未来即使关联对象发生变化,这个值是否仍然必须保持事件发生时的样子? 如果答案是“是”,它更适合作为事件自身数据保存。

为消费者提供稳定而不是万能的数据

事件字段还要考虑消费者的真实需求,但不要为了“以后也许会用”无限扩张。每增加一个字段,都意味着更大的消息体、更多敏感信息暴露面,以及更长久的兼容责任。

如果多个稳定消费者都必须查询同一份事件时数据,适度冗余是合理的;如果字段只是某个临时报表需要,优先让报表通过专门的读模型获取,而不是把领域事件改造成万能 DTO。

事件发布后通常会被持久化、转发或被多个系统长期消费,因此字段语义比字段数量更重要。字段名应表达明确业务含义,同一字段不要在不同版本中悄悄改变单位、时区或解释方式。

用最小充分集检查事件

提交事件设计前,可以逐个字段检查三个问题:删除它后,是否仍能准确说明这件业务事实;未来聚合结构变化时,它是否仍然有稳定含义;消费者是否真的需要事件发生时的值,而不是当前最新值。

如果删除某字段会让事实含义缺失,就应该保留;如果字段只是聚合内部结构的顺手复制,就应考虑移除。最终目标不是让事件尽可能小,而是形成“最小但充分”的事实记录:足够独立地解释发生了什么,又不过度泄露和复制领域模型。

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

目录与阅读设置

阅读设置

17

记录一个想法

领域事件里应该放多少数据

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

登录哪都通