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

识别架构坏味道与技术债

识别架构坏味道与技术债

架构坏味道不是“代码看起来不优雅”,而是已经开始增加变更成本、故障半径或恢复难度的结构性信号。本篇用循环依赖、共享数据库、过长同步链和不可观测四类证据完成识别、验证与修复排序。

学习目标

  • 用可观察证据区分局部代码问题与结构性架构问题
  • 识别四类常见坏味道背后的耦合、所有权与运行风险
  • 按风险和迁移成本制定可逐步回退的技术债修复顺序

从信号判断是否是结构性问题

坏味道的判断标准不是“是否违反某条架构原则”,而是它是否持续放大跨模块修改、部署联动或故障传播。先看证据,再决定是否重构,避免把正常复杂度误判成技术债。

信号 可验证证据 常见结构性问题
循环依赖 A 改动常要求 B 同步修改,B 又反向依赖 A 边界不清、职责互相渗透
共享数据库 多个服务直接写同一业务表 数据所有权缺失、发布耦合
同步链过长 单次请求跨越多个远程服务后才能返回 延迟叠加、故障半径扩大
不可观测 出错后无法关联请求、依赖和业务键 无法快速定位或验证恢复

架构坏味道从信号到修复优先级的诊断关系

用依赖图确认循环依赖

循环依赖可以先从模块引用关系入手。下面的完整 Python 示例对有向依赖图做深度优先搜索;只要发现某个节点重新进入当前递归路径,就输出一条循环路径。

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

预期输出:

text
cycle: order -> inventory -> pricing -> order

发现循环后不要直接“删掉一条依赖”。先确认双方真正共享的是业务规则、数据还是调用时机,再把稳定能力抽成单向契约,或通过领域事件解除反向依赖。否则只是把编译期循环变成运行期循环。

检查共享数据库和过长同步链

共享数据库最危险的不是“共用一个实例”,而是多个服务拥有同一业务数据的写权限。排查时应列出每张核心表的唯一写入者,再搜索其他服务中的直连写 SQL、ORM 映射和运维脚本。迁移时优先封住新增跨域写,再把旧写路径逐步改成 API 或事件。

同步链则从入口请求向下追踪实际远程调用。链越长,超时、重试和线程占用越容易层层放大。优先把“用户必须立即得到结果”的调用保留在同步路径,把通知、审计、搜索索引等非关键动作异步化,并为剩余调用统一传播 deadline,避免每一层重新获得完整超时预算。

把不可观测变成可验证问题

不可观测常与其他坏味道叠加:调用链已经很长,但没有 trace;共享写入已经存在,却无法从日志看出谁修改了数据。修复前先保证关键请求至少能关联入口、服务名、版本、依赖调用、错误类型和稳定业务键。

验证标准应直接服务于排障。例如一次订单失败后,应能从 order_id 找到入口日志,再定位对应 trace_id,看到哪个下游调用耗时或失败,并确认重试是否扩大了请求量。做不到这一点,就不能证明后续结构调整真正降低了风险。

按风险和迁移成本偿还技术债

技术债修复应从“影响大且持续发生”的问题开始,而不是从最容易改的地方开始。可以按下面顺序推进:

  1. 先处理可能造成数据错误或大面积故障的共享写入、无界重试和关键循环依赖。
  2. 再缩短高频请求的同步关键路径,补齐超时、隔离和幂等。
  3. 同步补齐观测能力,让每次结构改造都有前后对比证据。
  4. 对低频、低影响且迁移代价高的问题登记债务、限定扩散,不强行一次性重写。

可控的修复方案通常都有中间态和回退点:先建立新契约,再迁移一部分流量,验证指标后扩大范围,最后删除旧路径。这样技术债偿还本身不会变成新的高风险架构变更。

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

目录与阅读设置

阅读设置

17

记录一个想法

识别架构坏味道与技术债

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

登录哪都通