第2章 边界划分核心原则：单一职责、高内聚低耦合、最小接口原则
2.1 原则概述
解决方案的边界划分并非随意切割，而是遵循一组经过大量实践验证的核心原则。它们共同确保系统在变更、扩展和维护时保持可预测性。本章逐条拆解单一职责、高内聚低耦合与最小接口原则，并给出其在架构协同流程中的落地方法。
架构黄金三角：单一职责划定“做什么”，高内聚低耦合约束“内部关系”，最小接口定义“对外暴露”。三者缺一不可。
2.2 单一职责原则（SRP）
一个组件（服务、模块、类）只负责一组紧密相关的职能，且只有一条引起它变更的原因。在解决方案中，SRP 不仅适用于代码，更适用于整个子系统或微服务。
| 层面 | 单一职责表现 | 常见反例 |
|---|---|---|
| 微服务 | 一个服务只处理一个业务能力（如用户、订单） | “全能服务”同时操作订单、支付、通知 |
| 模块 | 模块内所有功能均围绕同一领域概念 | 一个模块既做数据校验又做日志归档 |
| 接口 | 一个接口方法只完成一次原子操作 | `saveOrUpdateAndNotify` 方法合并多种行为 |
过度拆分陷阱：SRP 并非越细越好。粒度低于业务上下文会导致“服务爆炸”，反而增加跨服务调用的耦合和运维成本。通常以业务限界上下文为最小拆分单位。
2.3 高内聚低耦合
高内聚指组件内部的元素（函数、数据、规则）在逻辑上紧密关联；低耦合指组件之间通过最少、最稳定的依赖进行交互。二者共同决定了系统的可维护性与可测试性。
| 指标 | 高内聚表现 | 低耦合表现 |
|---|---|---|
| 变更影响 | 修改内部实现不影响外部 | 一个组件变更时，受影响的组件数 ≤ 3 |
| 复用性 | 组件可被独立抽取到新场景 | 替换依赖时只需修改适配器，不波及业务逻辑 |
| 测试成本 | 可单独 mock 依赖进行单元测试 | 无需启动全部关联服务即可验证 |
在架构决策中，常见的耦合形式包括：
- 数据耦合：通过共享数据库表或同一缓存结构产生依赖 → 应通过 API 契约隔离。
- 控制耦合：传递标志位或配置字符串影响对方内部流程 → 改为策略模式或异步事件。
- 内容耦合：直接访问对方内部数据结构 → 必须引入防腐层。
2.4 最小接口原则
接口应只暴露使能协作所必要的方法和数据，隐藏所有可推导或内部实现细节。最小接口原则（Principle of Least Interface）与接口隔离原则（ISP）一脉相承，但更强调“暴露越少，变化冲击面越小”。
典型实践包括：
- 使用粗粒度接口进行服务间通信（如一次返回完整聚合），避免多次往返。
- 不在接口中出现内部数据结构（如数据库实体）。
- 严格版本化接口，废弃字段需保留但标记 deprecate。
# 反例：暴露内部实现细节的接口
GET /order/internalDetails (返回数据库原始字段 order_id，user_tel，db_version)
# 正例：只暴露业务所需
GET /order/summary (返回 orderId，status，totalAmount，paymentDeadline)
接口演进原则：如果无法确定是否应该暴露，先不暴露。用户需要时再通过协商添加，永远比“先暴露再删除”容易。
2.5 三原则协同落地检查表
在解决方案边界划分的协同流程中（通常包含架构师、开发、测试与领域专家），可使用以下检查表逐条评审。
| 检查项 | 原则对应 | 判定标准 | 输入物 | 输出物 |
|---|---|---|---|---|
| 组件职责描述是否包含多个动作（动词）？ | 单一职责 | 职责描述应只有一个核心动词 | 组件清单草稿 | 组件职责说明 v1 |
| 两个组件是否通过数据库表或配置文件直接产生依赖？ | 低耦合 | 所有跨组件通信必须经过 API 或消息 | 系统依赖图初稿 | 依赖图评审纪要 |
| 一个组件内是否有处理不同领域概念的逻辑？ | 高内聚 | 同一组件所有功能应为同一领域 | 组件内部模块图 | 模块合并/拆分决议 |
| 接口是否包含超过 3 个非业务必要参数？ | 最小接口 | 接口参数 ≤ 3 且皆为业务名词 | 接口定义文档 | 简化接口后版本 v1 |
2.6 协同异常处理
边界划分过程中最常见的异常及应对方案：
- 接口膨胀：评审时发现一个服务对外暴露超过 10 个接口 → 暂停扩展，重新评估是否属于单一职责违反，考虑聚合或拆分为独立服务。
- 循环依赖：两个组件互相调用 → 引入事件总线或中间层解耦，通常属于耦合度超标。
- 数据落地不一致：因最小接口导致接口返回不足，调用方自行查询原始表 → 立即补全接口，不可绕过。
上图展示了三个原则在典型分层架构中的体现：业务层各模块遵循单一职责；数据访问层内部高内聚、模块间低耦合；基础设施层对外暴露最小接口。右侧说明框列出了每条原则的本地化检查点，可作为 架构评审 checklist 直接使用。