架构与系统设计 / 系统课时
画出第一张事件驱动架构图
画出第一张事件驱动架构图
把订单服务、消息中间件和消费者连起来,并不等于讲清异步业务。本篇以“订单确认后更新统计并发送通知”为例,画出能说明事件归属、独立消费、外部依赖和失败边界的第一张架构图。
学习目标
- 用生产者、事件、Broker、消费者和外部依赖描述完整链路。
- 区分同步调用、异步消息与独立订阅。
- 在架构图中标明成功条件和待解决的可靠性问题。
先确定业务事实和终点
本例约定:订单服务完成本地事务后,订单成为“已确认”;统计消费者累计订单金额,通知消费者调用支持按客户标识发送消息的通知 API。客户端收到“订单已确认”,不代表统计和通知已经完成。
先写清这句话,再画组件。图的起点是确认订单的请求,两个终点分别是统计数据写入成功、通知 API 接受请求。通知是否真正送达属于另一项结果,不应被接口调用成功替代。
把组件和箭头画对
事件驱动架构的主干是生产者、事件通道和消费者。本例让统计与通知各有独立订阅,两者都需要收到同一事件;这不同于多个工作者竞争同一队列中的任务。([Microsoft Learn][1])
从左向右画订单服务、Broker 和两个消费者,订单库放在订单服务下方,统计库和通知 API 放在对应消费者右侧。事件名称写在消息箭头上,不要把事件画成需要单独部署的服务。

灰色实线表示数据库访问或同步 API 调用,蓝色虚线表示异步消息。不要为了让整张图“看起来异步”,把消费者调用外部 API 的同步等待也画成消息。
方框表示逻辑职责,不代表只能部署一个实例。扩容统计消费者,不等于增加一个新的业务订阅;是否竞争处理、怎样分配消息,需要在具体中间件配置中落实。
用一份事件检查数据是否够用
下面是本例自定义的完整事件数据结构,不是某个 Broker 的配置文件。<ID> 分别替换为对应标识,并不表示这些标识相同;<TIME> 替换为实际发生时间,采用带时区的 ISO 8601 字符串。
{
"eventId": "<ID>",
"eventType": "OrderConfirmed",
"schemaVersion": 1,
"occurredAt": "<TIME>",
"data": {
"orderId": "<ID>",
"customerId": "<ID>",
"totalAmountMinor": 12900,
"currency": "CNY"
}
}预期结果:评审时,统计分支能够指出金额和币种字段,通知分支能够指出客户和订单字段。本例金额以分计,12900 表示 129 元;同一事件的重试保留原 eventId,不要每次发送都生成新的事件身份。
请分别沿两条箭头检查输入是否齐全。若实际通知 API 还要求邮箱,而事件和消费者本地数据都没有邮箱,就必须补画资料查询依赖,不能用“消费者自行处理”掩盖缺失的数据来源。
把失败边界纳入验收
订单库提交与事件发布是两个写入动作。只画一条连接线不能消除“订单已提交、事件未发出”的缺口;可将事务性 Outbox 标为待落实方案,即业务数据与待发事件同事务保存,再由独立发布过程发送。([AWS 文档][2])
Broker 确认接收,不等于消费者业务完成。以 RabbitMQ 为例,发布确认和消费确认承担不同责任;连接失败后的重发还可能产生重复,因此消费者必须考虑幂等处理。([RabbitMQ][3])
用两次桌面推演验收这张图:
- 订单提交后发布失败:能指出未发布事件由谁保存、谁补发;若尚未实现,明确标成风险,不能宣称可靠投递。
- 通知 API 超时:能指出通知分支的失败暂存、重试和防重责任,并检查统计分支是否仍可独立处理;共享 Broker 的资源压力仍可能影响双方。
一张可用的初版架构图,应让读者沿箭头找到数据来源、业务终点和失败责任,而不是只认出几个中间件名称。