架构与系统设计 / 系统课时
用系统上下文图锁定边界
用系统上下文图锁定边界
系统上下文图先回答“系统与谁发生关系、责任到哪里结束”,再谈服务、数据库和组件。完成本篇后,你可以用一张图把用户、外部系统、核心系统与关键交互锁定下来,并据此发现边界遗漏与责任混淆。
学习目标
- 识别系统、用户角色与外部系统,明确图中应该出现和不该出现的对象
- 用有方向、有语义的关系表达跨边界交互,而不是堆砌技术组件
- 通过上下文图评审系统责任、外部依赖和待确认边界
先决定“什么是系统”
上下文图把目标系统视为一个黑盒。图的中心只放“你正在设计或改造的系统”,不展开内部服务、模块、数据库、消息队列和部署节点。它的价值正是暂时压住内部实现细节,让讨论集中在边界与责任上。
画图前先写一句系统职责,例如“订单履约平台负责接收订单、协调支付结果并驱动仓储履约”。如果这句话同时包含多个独立业务责任,先确认它们是否真的属于同一系统;如果连一句职责都写不清,直接画组件图通常只会把歧义藏进更多方框。
从外部关系开始画
可以按下面顺序构建第一版上下文图:
- 把目标系统放在中心,并写清业务名称,不使用“平台”“中台”这类无法判断责任的泛化名称。
- 在外围加入真正与系统交互的用户角色,例如买家、运营人员,而不是部门组织架构。
- 加入系统无法直接控制的外部系统,例如支付平台、仓储系统、身份提供方。
- 为每条关系标注方向与业务目的,例如“提交订单”“查询支付结果”“下发出库指令”。

这张图应能让第一次参加评审的人在几十秒内回答三个问题:谁在使用系统、系统依赖谁、系统对外承担什么责任。若必须先解释内部服务才能读懂,说明图已经越过上下文层级。
给跨边界关系写清责任
箭头不是“能连通”就够了。每条跨边界关系至少要说清业务动作和责任归属,尤其是失败处理到底由哪一侧承担。
| 关系 | 主要输入 | 主要输出 | 边界关注点 |
|---|---|---|---|
| 买家 → 订单履约平台 | 下单请求 | 订单受理结果 | 平台负责校验并返回可追踪的订单标识 |
| 订单履约平台 → 支付平台 | 支付请求 | 支付状态 | 支付能力属于外部依赖,平台负责处理超时与重复通知 |
| 订单履约平台 → 仓储系统 | 出库指令 | 履约状态 | 仓储执行属于外部责任,平台负责跟踪结果并处理失败 |
不要在上下文图上写接口路径、Topic 名、表名或类名。这些信息会把评审过早拉到实现层,而且一旦实现变化,边界图就会迅速失真。
用上下文图做边界评审
评审时不要问“图画得好不好看”,而是逐条验证边界是否成立:
- 是否存在没有任何外部使用者、却被画成独立系统的对象
- 是否把团队可控制的内部组件误画成外部系统
- 是否遗漏了身份、支付、通知、监管或人工操作等真实依赖
- 每条跨边界关系是否有明确方向、业务目的和失败责任
- 系统名称是否足以让非开发角色理解其职责
在边界稳定后再深入内部
上下文图不是完整架构设计,它是后续设计的入口。只有当系统职责、外部参与者和跨边界关系基本稳定后,才适合继续拆容器、服务、数据存储和通信机制。这样做可以避免内部结构设计得很精细,却发现系统本身承担了错误的责任。
按自己的节奏,确认真正理解。