架构与系统设计 / 系统课时
识别架构坏味道与技术债
识别架构坏味道与技术债
架构坏味道不是“代码看起来不优雅”,而是已经开始增加变更成本、故障半径或恢复难度的结构性信号。本篇用循环依赖、共享数据库、过长同步链和不可观测四类证据完成识别、验证与修复排序。
学习目标
- 用可观察证据区分局部代码问题与结构性架构问题
- 识别四类常见坏味道背后的耦合、所有权与运行风险
- 按风险和迁移成本制定可逐步回退的技术债修复顺序
从信号判断是否是结构性问题
坏味道的判断标准不是“是否违反某条架构原则”,而是它是否持续放大跨模块修改、部署联动或故障传播。先看证据,再决定是否重构,避免把正常复杂度误判成技术债。
| 信号 | 可验证证据 | 常见结构性问题 |
|---|---|---|
| 循环依赖 | A 改动常要求 B 同步修改,B 又反向依赖 A | 边界不清、职责互相渗透 |
| 共享数据库 | 多个服务直接写同一业务表 | 数据所有权缺失、发布耦合 |
| 同步链过长 | 单次请求跨越多个远程服务后才能返回 | 延迟叠加、故障半径扩大 |
| 不可观测 | 出错后无法关联请求、依赖和业务键 | 无法快速定位或验证恢复 |

用依赖图确认循环依赖
循环依赖可以先从模块引用关系入手。下面的完整 Python 示例对有向依赖图做深度优先搜索;只要发现某个节点重新进入当前递归路径,就输出一条循环路径。
from collections import defaultdict
dependencies = [
('order', 'inventory'),
('inventory', 'pricing'),
('pricing', 'order'),
('shipping', 'order'),
]
graph = defaultdict(list)
for source, target in dependencies:
graph[source].append(target)
visiting = set()
visited = set()
path = []
def find_cycle(node):
if node in visiting:
start = path.index(node)
return path[start:] + [node]
if node in visited:
return None
visiting.add(node)
path.append(node)
for neighbor in graph[node]:
cycle = find_cycle(neighbor)
if cycle:
return cycle
path.pop()
visiting.remove(node)
visited.add(node)
return None
for module in list(graph):
cycle = find_cycle(module)
if cycle:
print('cycle:', ' -> '.join(cycle))
break预期输出:
cycle: order -> inventory -> pricing -> order发现循环后不要直接“删掉一条依赖”。先确认双方真正共享的是业务规则、数据还是调用时机,再把稳定能力抽成单向契约,或通过领域事件解除反向依赖。否则只是把编译期循环变成运行期循环。
检查共享数据库和过长同步链
共享数据库最危险的不是“共用一个实例”,而是多个服务拥有同一业务数据的写权限。排查时应列出每张核心表的唯一写入者,再搜索其他服务中的直连写 SQL、ORM 映射和运维脚本。迁移时优先封住新增跨域写,再把旧写路径逐步改成 API 或事件。
同步链则从入口请求向下追踪实际远程调用。链越长,超时、重试和线程占用越容易层层放大。优先把“用户必须立即得到结果”的调用保留在同步路径,把通知、审计、搜索索引等非关键动作异步化,并为剩余调用统一传播 deadline,避免每一层重新获得完整超时预算。
把不可观测变成可验证问题
不可观测常与其他坏味道叠加:调用链已经很长,但没有 trace;共享写入已经存在,却无法从日志看出谁修改了数据。修复前先保证关键请求至少能关联入口、服务名、版本、依赖调用、错误类型和稳定业务键。
验证标准应直接服务于排障。例如一次订单失败后,应能从 order_id 找到入口日志,再定位对应 trace_id,看到哪个下游调用耗时或失败,并确认重试是否扩大了请求量。做不到这一点,就不能证明后续结构调整真正降低了风险。
按风险和迁移成本偿还技术债
技术债修复应从“影响大且持续发生”的问题开始,而不是从最容易改的地方开始。可以按下面顺序推进:
- 先处理可能造成数据错误或大面积故障的共享写入、无界重试和关键循环依赖。
- 再缩短高频请求的同步关键路径,补齐超时、隔离和幂等。
- 同步补齐观测能力,让每次结构改造都有前后对比证据。
- 对低频、低影响且迁移代价高的问题登记债务、限定扩散,不强行一次性重写。
可控的修复方案通常都有中间态和回退点:先建立新契约,再迁移一部分流量,验证指标后扩大范围,最后删除旧路径。这样技术债偿还本身不会变成新的高风险架构变更。