领域事件（Domain Event）

用途：跨聚合、跨上下文协调变更，或需要审计“发生过什么”时查阅

定义

领域事件是对业务上已经发生的事实的不可变描述，命名使用过去式（OrderPaid、ShipmentArrived、PolicyCancelled）。它声明“发生了什么”，不声明“该做什么”。

三个必备要素：事实（已发生）、时间（何时）、上下文（哪个聚合/标识）。事件一旦产生不可修改，纠正只能靠新事件。

聚合之间不允许放在同一事务里改，跨聚合与跨上下文的一致性需要一种解耦的传播机制。同步调用会把调用方与接收方的可用性、发布节奏绑在一起；事件把这种耦合降级为“契约耦合”，允许各自演进与延迟一致。

概念	语义	归属	例子
领域事件	业务事实	领域层	`PaymentConfirmed`
命令（Command）	请求执行的动作	应用层入口	`PayOrder`
集成消息	为下游系统准备的传输契约	基础设施/适配层	含外部字段的 `payment-confirmed.v2` JSON
变更数据捕获（CDC）	数据层的变化流	基础设施	binlog 行变更

最容易出的错是把领域事件直接当作集成消息发出去：内部模型细节外泄，之后任何字段调整都变成破坏性变更。正确做法是内部领域事件 → 发布语言（显式 Schema）→ 外部消息。

事件传递只有三种真实保证，工程上必须说清用了哪种：

Outbox 模式是落地至少一次的标准做法：业务数据与事件在同一本地事务内落库（事件表与业务表同库），再由后台任务或 CDC 投递到消息中间件，投递成功后标记。它解决“事务提交了但事件没发出去”以及“发了但事务回滚”两个经典缺陷。

开源参考：Debezium（CDC 投递 Outbox）、Apache Kafka / RocketMQ（事件通道）、Axon Framework（事件存储与订阅）、Spring Modulith（模块内事件与文档化）。