消息队列 / 系统课时
事件与命令的边界
事件与命令的边界
Kafka 既能传递“请求别人做事”的命令,也能传播“某件事已经发生”的事件。真正影响可治理性的不是消息格式,而是发送方对接收方的期待。本课用业务语义、责任归属和失败处理三个维度划清 Event、Command 与 Notification 的边界,避免把 Topic 设计成隐蔽的远程调用接口。
学习目标
- 能根据消息语义判断它属于 Event、Command 还是 Notification
- 能识别“用事件名包装命令”的强耦合 Topic 设计
- 能为三类消息选择合适的生产者、消费者与失败处理方式
先看发送方到底想表达什么
判断消息类型时,不要先看 Topic 名,而要问发送方一句:你是在陈述事实,还是要求某个能力被执行?
Command 表达意图,例如“创建退款”“冻结账户”。它通常指向一个明确的业务能力,接收方拥有是否执行、如何执行以及如何返回失败的责任。即使通过 Kafka 异步投递,它仍然具有“请求”的语义。
Event 表达已经发生且不可撤回的业务事实,例如“订单已支付”“退款已完成”。生产者只负责准确发布事实,不应知道有哪些下游会订阅,也不应要求某个特定消费者必须据此执行某动作。
Notification 更接近“把信息送给人或外部渠道”,例如“向用户发送支付成功短信”。它的核心是传递与展示,而不是记录领域事实。通知失败通常可以重试、降级或换渠道,但不会改变“订单已支付”这个事实本身。

用责任归属检查 Topic 设计
最容易出问题的情况,是把 Command 伪装成 Event。例如生产者发送 user-sync-requested,但实际上只有“用户中心”能够处理,发送方还会等待处理成功后再继续。它虽然用了过去分词式命名,语义仍然是命令。
可以用三个问题快速检查:
- 消息是否存在一个天然的唯一处理方?如果“必须由某个服务执行”,更像 Command。
- 生产者是否关心处理成功或失败?如果业务流程必须得到结果,更像 Command。
- 新增消费者是否应该完全不影响生产者?如果可以自由订阅并各自行动,更像 Event。
Event Topic 应该按业务事实建模,而不是按某个消费者的动作建模。order-paid 比 send-invoice 更适合作为领域事件:前者描述事实,发票、积分、风控都能独立订阅;后者直接把生产者和“开发票”能力绑在一起。
对比三类消息的结构语义
下面是三个片段示例,它们展示同一业务链路中三类消息各自表达什么,依赖具体系统的统一信封与 Topic 约定,不能单独运行。
{
"type": "Command",
"name": "CreateRefund",
"orderId": "order-42",
"amount": 12800
}{
"type": "Event",
"name": "RefundCompleted",
"orderId": "order-42",
"refundId": "refund-9"
}{
"type": "Notification",
"name": "SendRefundSuccessMessage",
"userId": "user-7",
"template": "refund-success"
}这三条消息不能互换。第一条要求退款能力执行操作;第二条说明退款事实已经成立;第三条只是把结果通知用户。尤其不要用第三条替代第二条,否则其他业务系统只能依赖“是否发送通知”来推断退款状态,语义会被渠道细节污染。
失败处理也能反推消息类型
Command 失败意味着请求没有完成,通常需要明确的重试、拒绝、超时或补偿语义。若调用方必须在后续流程中知道结果,可以配合结果事件、状态查询或请求响应模式,但不要假装它是“无关消费者的广播事件”。
Event 消费失败通常意味着某个订阅者还没有处理这个事实,而不是事实本身失败。生产者不应因为邮件消费者暂时异常,就撤销“订单已支付”。每个消费者应独立处理重试、死信和幂等。
Notification 失败影响的是送达体验。系统可记录失败、切换渠道或稍后重发,但领域状态应由真正的业务事件决定。
什么时候该选哪一种
需要“让某个能力执行动作”时使用 Command;需要“公布已经发生的业务事实”时使用 Event;需要“把已有信息送达到人或外部渠道”时使用 Notification。工程上允许三者都走 Kafka,但必须在命名、所有权、重试策略和契约治理上保留语义差异。边界清楚后,Topic 才能随着消费者增加而扩展,而不会逐渐退化成难以发现依赖关系的远程调用网络。