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

画出第一张事件驱动架构图

画出第一张事件驱动架构图

把订单服务、消息中间件和消费者连起来,并不等于讲清异步业务。本篇以“订单确认后更新统计并发送通知”为例,画出能说明事件归属、独立消费、外部依赖和失败边界的第一张架构图。

学习目标

  • 用生产者、事件、Broker、消费者和外部依赖描述完整链路。
  • 区分同步调用、异步消息与独立订阅。
  • 在架构图中标明成功条件和待解决的可靠性问题。

先确定业务事实和终点

本例约定:订单服务完成本地事务后,订单成为“已确认”;统计消费者累计订单金额,通知消费者调用支持按客户标识发送消息的通知 API。客户端收到“订单已确认”,不代表统计和通知已经完成。

先写清这句话,再画组件。图的起点是确认订单的请求,两个终点分别是统计数据写入成功、通知 API 接受请求。通知是否真正送达属于另一项结果,不应被接口调用成功替代。

把组件和箭头画对

事件驱动架构的主干是生产者、事件通道和消费者。本例让统计与通知各有独立订阅,两者都需要收到同一事件;这不同于多个工作者竞争同一队列中的任务。([Microsoft Learn][1])

从左向右画订单服务、Broker 和两个消费者,订单库放在订单服务下方,统计库和通知 API 放在对应消费者右侧。事件名称写在消息箭头上,不要把事件画成需要单独部署的服务。

订单确认事件的独立订阅与外部依赖

灰色实线表示数据库访问或同步 API 调用,蓝色虚线表示异步消息。不要为了让整张图“看起来异步”,把消费者调用外部 API 的同步等待也画成消息。

方框表示逻辑职责,不代表只能部署一个实例。扩容统计消费者,不等于增加一个新的业务订阅;是否竞争处理、怎样分配消息,需要在具体中间件配置中落实。

用一份事件检查数据是否够用

下面是本例自定义的完整事件数据结构,不是某个 Broker 的配置文件。<ID> 分别替换为对应标识,并不表示这些标识相同;<TIME> 替换为实际发生时间,采用带时区的 ISO 8601 字符串。

json
{
  "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])

用两次桌面推演验收这张图:

  1. 订单提交后发布失败:能指出未发布事件由谁保存、谁补发;若尚未实现,明确标成风险,不能宣称可靠投递。
  2. 通知 API 超时:能指出通知分支的失败暂存、重试和防重责任,并检查统计分支是否仍可独立处理;共享 Broker 的资源压力仍可能影响双方。

一张可用的初版架构图,应让读者沿箭头找到数据来源、业务终点和失败责任,而不是只认出几个中间件名称。

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

目录与阅读设置

阅读设置

17

记录一个想法

画出第一张事件驱动架构图

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

登录哪都通