架构与系统设计 / 系统课时
用内聚与耦合检查拆分质量
用内聚与耦合检查拆分质量
模块拆完不等于边界合理。本篇用“共同变化、数据依赖、调用频率”三类证据检查拆分质量,并据此识别职责过散、循环依赖和高耦合接口,最后给出一套可重复执行的边界复核顺序。
学习目标
- 用共同变化判断一个模块内部是否足够内聚
- 用数据依赖和调用频率识别跨模块耦合是否过高
- 根据循环依赖、连锁修改和高频跨界调用决定合并、重划边界或收窄接口
把边界质量变成三类证据
内聚关注“模块内部的东西是否因为同一个业务原因而变化”,耦合关注“一个模块要知道另一个模块多少细节才能工作”。两者不能只看类名或目录结构,而要回到真实变更和运行行为。
| 检查维度 | 观察内容 | 边界健康时的表现 |
|---|---|---|
| 共同变化 | 同一需求、缺陷修复会改哪些文件和模块 | 一类业务变化大多收敛在一个模块 |
| 数据依赖 | 是否跨边界读取内部表、对象字段或共享模型 | 只交换稳定、明确的业务数据 |
| 调用频率 | 一次业务动作需要跨模块调用多少次 | 跨界调用围绕完整业务意图,而非逐字段取数 |
共同变化是最重要的信号。如果“修改优惠规则”总要同时改订单、价格和营销三个模块,说明职责可能被拆散;反过来,两个目录总是成对修改,也可能说明它们本来就是一个变化单元。
数据依赖暴露的是知识泄漏。A 模块如果必须理解 B 模块的表结构、状态字段组合甚至内部对象生命周期,形式上虽然分开,实际上仍共享同一份设计细节。
调用频率则能发现“聊天式接口”。一次下单要向库存模块连续调用“查库存、锁库存、查锁定结果、扣库存、查扣减结果”,通常意味着边界没有承载完整业务意图。

用一个小检查器筛出高风险边界
下面的脚本把三类证据转成可讨论的信号。阈值只是教学示例,真实项目应根据仓库规模、调用延迟和业务节奏校准,而不是把分数当成架构结论。
metrics = [
{"boundary": "order -> inventory", "co_change": 0.82, "shared_fields": 6, "calls_per_request": 12},
{"boundary": "order -> promotion", "co_change": 0.64, "shared_fields": 2, "calls_per_request": 8},
{"boundary": "order -> notification", "co_change": 0.18, "shared_fields": 1, "calls_per_request": 1},
]
for item in metrics:
risks = []
# 共同变化高,说明两个边界可能在承载同一个变化原因。
if item["co_change"] >= 0.70:
risks.append("共同变化过高")
if item["shared_fields"] > 3:
risks.append("跨边界数据依赖过多")
# 高频往返常见于接口过细,业务意图没有被一次表达完整。
if item["calls_per_request"] > 5:
risks.append("调用过于频繁")
result = "、".join(risks) if risks else "暂无明显信号"
print(f'{item["boundary"]}: {result}')预期输出
order -> inventory: 共同变化过高、跨边界数据依赖过多、调用过于频繁
order -> promotion: 调用过于频繁
order -> notification: 暂无明显信号这段输出不是自动裁决,而是告诉评审者“先看哪里”。例如 order -> inventory 同时命中三类信号,就应优先检查两个模块是否被人为拆开,或者是否缺少一个能表达“预占库存”完整意图的接口。
识别三种典型拆分失败
职责过散的直接症状是一个业务变化穿透多个模块。修复方式通常不是再加一层调用,而是重新确认变化原因,把经常共同变化的规则放回同一边界;只有在它们拥有不同生命周期、团队责任或伸缩需求时,才值得继续拆开。
循环依赖说明模块之间没有稳定的主从方向。若出现 A 依赖 B、B 依赖 C、C 又依赖 A,任何一个模块都无法独立理解和替换。常见处理方式是抽出共同概念、把协调职责上移到应用层,或重新定义谁拥有核心业务决策。
高耦合接口常表现为参数过多、暴露内部字段、一次业务操作需要多次往返。此时应优先把接口改成业务动作,例如用“预占指定商品数量”代替“查数量、写锁、改状态”三个细粒度动作。
按固定顺序做边界复核
先从最近一批真实需求和缺陷中抽样,记录哪些模块经常一起变化;再检查这些模块是否共享内部数据模型;最后观察一条核心业务链路里跨边界调用的次数和方向。三个维度同时异常时,优先处理,因为它往往不是局部代码问题,而是边界本身有误。
一个好的拆分最终应满足:业务变化有明确归属,跨边界只暴露必要信息,调用能表达完整意图,而且依赖关系不会形成闭环。做到这几点,目录上的分层才真正变成可演进的模块边界。