架构视界
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
主页
企业架构
  • 方案总览
  • 业财一体
  • 企业中台
  • 组织与绩效
  • 流程治理
数据收集与分析
  • 转型总览
  • 信息化阶段
  • 数字化解决方案
  • 智数化解决方案
  • 智能化解决方案
  • 产品设计
  • 项目管理
全栈软件工程
AI 原生软件工程
方法论
博客
  • 资源导航
  • 效率工具
  • 展示专区
  • 标签索引
  • 2024年

    • 勇闯大A:美债与美元周期
    • 勇闯大A:交易纪律与自我管理
    • 勇闯大A:交易系统分层
    • 勇闯大A:买卖点与止损规则
    • 勇闯大A:债券与资金流向
    • 勇闯大A:微观、宏观与周期
    • Mac 开发环境:新机配置清单
    • 勇闯大A:内外盘与换手率
    • 会计管理:财报阅读与管理报表
    • 会计基础:记账原理与分录
    • 财务入门:财务体系全景
  • 2023年

    • 境外投资:泰国 BOI 申请实务
  • 2022年

    • 企业架构:故障管理与分级响应
    • 企业架构:技术债务的识别、度量与偿还
  • 2021年

    • Python 数据分析:员工分布可视化
    • Python 数据分析:IP 访问折线图
    • Python 数据分析:IP 词云图
    • Redis:RediSearch 全文检索
    • Rust 基础:第一个 CLI 程序
    • Rust 基础:所有权机制
    • Rust 基础:函数与控制流
    • Rust 基础:变量与数据类型
    • Rust 基础:入门与开发环境
    • 企业架构:分布式系统设计
    • 企业架构:编程式权限设计
    • JVM 调优:启动参数与 GC 日志
    • MyBatis 批量插入:三种写法对比
    • 测试:Spring Boot 分层 Mock
    • Redis:布隆过滤器判断元素存在
    • Jenkins:安装配置与应用部署
    • WebClient:非阻塞 HTTP 客户端
    • Drone:Docker 部署轻量 CI
    • Spring AOP:操作审计日志落库
    • Redisson:分布式锁与 RedLock
    • MyBatis 拦截器:雪花算法主键
    • Netty:线程模型与网络编程
    • Redis:SCAN 游标遍历大键空间
    • Jenkins:单机部署与升级脚本
    • Mac:Neo4j 与 Jupyter 安装
    • JavaFX:OpenJDK 11 环境配置
    • Mac:用 jenv 管理 JDK 版本
    • Redis:有序集合实现延时队列
    • Spring Boot 日志:MDC 串联链路
    • 定时任务:Spring 调度与 Cron
    • GoAccess:Nginx 日志分析
    • MyBatis 拦截器:慢 SQL 分析
    • Lucene:倒排索引与中文分词
    • 分布式锁:三种实现方案对比
    • 学习技巧:减少学习排斥心理
    • 动态数据源:多租户数据路由
    • Compose:Spring Boot 三件套
    • Java 阻塞队列:源码与用法
    • Redis:Docker Compose 哨兵
    • Redis:Docker Compose 主从
    • 网络通信:TCP/IP 与 HTTP 基础
  • 2020年

    • 延时队列:DelayQueue 与 Redis 实现
    • MySQL 基础:员工库导入实践
    • 雪花算法:分布式 ID 生成
    • Redis:地理位置查询
    • 抓包:Wireshark 与 Tcpdump
    • SPI:JDK 与 Spring 扩展机制
    • ZooKeeper:概念与集群搭建
    • Spring Boot:集成 JMH 基准测试
    • Wireshark:抓包工具入门
    • Compose:Redis 与 MySQL
    • CentOS 7:Docker 安装部署
    • Netty:源码阅读环境搭建
    • MySQL 基础:SQL 常见用法
    • CentOS 7:Selenium 运行环境
    • Nginx:HTTPS 证书配置
    • JMH:基准测试与 Spring Boot 集成
    • Spring Boot:指定 Tomcat 版本
    • Eureka:实例上下线告警
    • 钉钉告警:应用异常与实例上下线
    • JVM:内存布局、类加载与调优
    • Git:rebase 合并多次提交
    • CentOS 7:OpenResty 部署
  • 2019年

    • Redis CLI:macOS 安装与使用
    • Nginx:访问日志格式
    • 工程规范:可维护代码的写法
    • IntelliJ IDEA:常用插件
    • SkyWalking:源码阅读环境搭建
    • Spring Boot:Redis 超时配置
    • gRPC:ProtoBuf 定义与代码生成
    • Arthas:Java 线上问题诊断
    • Redis:缓存穿透与击穿防护
    • Docker 部署:Elasticsearch
    • Docker 部署:MySQL 5.7 单机
    • Spring Redis:字符串命令封装
    • Docker 部署:ZooKeeper 运行
    • Docker 部署:Redis 单机运行
    • Dubbo:Spring Boot 微服务集成
    • CentOS 7:CMake 源码编译安装
    • 性能度量:吞吐量与 QPS 指标
    • Java 递归:从笔试题到经典问题
    • CentOS 7:ELK 日志平台部署
    • CentOS 7:SonarQube 部署
    • Selenium:Chrome 浏览器自动化
    • JJWT:令牌生成与解析测试
    • Spring 源码:阅读环境搭建
    • JUnit 4:注解、断言与参数化
    • JWT:令牌结构与签名机制
    • FastDFS:架构与文件存取机制
    • XPath:XML 文档节点定位
    • Redis 基础:锁、队列与事务
    • Redis 基础:数据类型与命令
    • MyBatis:Slf4j 日志接入
    • MyBatis:H2 单元测试与 SQL 日志
    • 源码阅读:开源项目环境搭建
    • Git 配置:命令清单与作用域
    • Java 核心:面向对象与基础类型
    • Java 核心:关键字、异常与反射
    • Java 核心:多线程基础
    • Java 核心:同步关键字与线程池
    • Java 核心:锁与并发工具
    • Java 核心:语言基础与并发
    • Dubbo:远程调用与服务治理
    • Java 集合:框架总览与实现对比
    • Maven:生命周期与常用命令
    • MyBatis:执行流程与插件机制
    • Spring:IoC 容器与依赖注入
    • Spring:AOP 与自动装配
    • Spring:事务与启动流程
    • Spring:IoC、AOP 与事务
    • Spring MVC:请求分发与注解
    • MySQL:架构与索引
    • MySQL:事务、锁与 MVCC
    • MySQL:日志与 SQL 优化
    • MySQL:架构、事务与优化
    • Redis 基础:持久化与线程模型
  • 2018年

    • Java HashMap:扩容机制与哈希冲突
    • Java 集合:HashSet 去重原理
    • Java 基础:交换两个变量的值
    • Spring MVC:零 web.xml 改造
    • Mac 开发环境:新机配置清单
    • Log4j:日志分级与按业务拆分
    • Modbus:工业通信协议与 RTU 帧
    • MySQL 基础:子查询与连接查询
    • MySQL 基础:库与表操作
    • MySQL 基础:表操作与查询
    • MySQL 基础:约束、引擎与数据类型
    • MySQL 基础:库表、约束与类型
    • Java 集合:Vector 与 Stack
    • Java 集合:Vector 与 Stack
    • RabbitMQ:CentOS 7 单机部署
    • Redis:CentOS 7 单机部署
    • MongoDB:CentOS 7 单机部署
    • Linux:常用系统与运维命令
    • 注册中心:Eureka 与 ZooKeeper
    • MySQL:CentOS 7 单机部署
    • Git 分支:主分支与临时分支
    • CentOS 7:Java 开发环境部署
    • Java 集合:LinkedList 双向链表
    • Java 集合:ArrayList 动态数组
    • Spring AOP:注解方式实现切面
← 返回博客

企业架构:技术债务的识别、度量与偿还

2022年5月16日 #企业架构

技术债务常被当成团队能力问题,实际上它首先是决策的结果:为了赶窗口期、抢收益,主动选择先上线、后补齐。债务本身是中性的,真正决定后果的是利息高低和偿还能力。本文基于一次历史项目治理的实践整理,讨论如何让债务可见、可量化、可排期。

债务从哪里来

历史项目出现债务,通常不是因为某一次错误,而是长期缺少清理机制:

  • 代码在不同项目之间复制迁移,重复部分随时间增加;
  • 功能仍在运行,但回归测试成本持续上升;
  • 新需求需要先理解旧逻辑,迭代维护越来越困难;
  • 新功能开发周期变长,投入产出比下降;
  • 长期处理债务会消耗开发人员的心态与耐心。

这些现象背后是五类债务:

类型典型表现
代码债务重复代码、坏味道、风格混乱、魔法值、条件分支过多、异常处理缺失、安全风险、严重耦合
设计债务缺少设计、对非功能性需求认识不足、系统性风险
测试债务缺少测试、覆盖率不足、有测试但长期不运行
质量债务缺少稳定性与健壮性验证、版本控制模糊、环境参数混乱
文档债务没有技术文档或设计文档、文档过期

五个可观测信号

把债务当成贷款,判断是否该“还”的核心是利息。以下信号可以用来度量利息是否正在上升:

  1. 交付速度下降。 正常迭代下,单位时间完成的任务量应保持接近;如果明显下滑,通常不是人员突然变慢,而是理解、修改和验证的成本变高。
  2. 测试覆盖率下降。 覆盖率工具给出的数字不必追求满分,但持续下降意味着改动缺少安全网。
  3. 静态检查告警增加。 历史代码中的规则告警长期不处理,会掩盖新引入的问题。
  4. 线上缺陷不降反升。 没有大版本开发时,缺陷数量本应缓慢下降;若维持高位甚至增加,说明稳定性在恶化。
  5. 理解成本高于实现成本。 新增功能可能只需要 100 行代码,但搞清楚它应该放在哪个模块、会影响哪些系统,往往要花数倍时间。

这五个信号不需要同时出现。出现任意两个并持续一个迭代周期,就值得进入治理排期。

四种偿还策略

策略没有绝对好坏,选择标准是投入产出比:

策略做法适用条件主要风险
重写推翻重来,一次还清边界清晰、行为有测试或可对照、业务窗口允许周期长,容易在重写期间丢失隐性规则
维持修修补补,只还利息模块即将下线,或改动频率极低利息持续累积,最终无法维持
重构新旧交替,分期偿还大部分场景,可按模块小步替换缺少测试时容易改出回归
投资在新建模块中采用更好的设计与规范新项目、新服务只对新代码生效,旧债仍在

此外还有两种日常动作:

  • 测试与评审:代码审查、单元测试、设计评审属于预防性投入,成本低于事后治理。
  • 记账:因进度压力走了捷径,就把债务记录到任务系统,明确后续偿还批次,而不是依赖记忆。

落地路径

治理顺序可以概括为四步:达成共识 → 债务可见 → 及时止损 → 持续改善。

  1. 建立共识。 让团队理解债务会直接影响业务交付,而不只是代码美观问题。共识不靠一次宣讲,靠把债务与具体业务指标关联起来。
  2. 识别并标记。 从服务依赖、文件职责、函数复杂度、重复代码、魔法值、接口参数等维度盘点,汇总到统一的问题池,并关联业务线。
  3. 排期与止损。 优先处理影响服务稳定性和线上故障的问题,再按与业务的相关程度分级。新增代码执行更严格的规范,避免边还边欠。
  4. 循环复盘。 用 PDCA 推进:规划、执行、检查、调整;用 WBS 拆解任务、识别依赖和关键路径;用 MVP 控制单批范围,先交付可用结果,再迭代完善。

几个工具在其中的作用:

  • PDCA:把治理变成持续循环,而不是一次性运动;
  • WBS:把“治理技术债务”拆成可分配、可验收的任务;
  • MVP:先解决最痛的一段,用结果争取后续资源;
  • ROI:用投入产出比决定先还哪一笔,而不是按技术洁癖排序。

边界与误区

  • 债务不等于坏代码。 有明确偿还计划的捷径是融资;没有计划的捷径才是负债。
  • 重写不是默认答案。 缺少测试和领域知识时,重写的失败率高于渐进重构。
  • 治理不等于停机整理。 可持续的做法是把清理嵌入日常迭代,每批次消化一部分。
  • 指标不能代替判断。 覆盖率、告警数、缺陷数都是信号,不是目标本身;为了指标而写测试,会制造新的债务。

小结

  • 技术债务是主动或被动决策的结果,关键指标是利息与偿还能力。
  • 债务分为代码、设计、测试、质量、文档五类,表现不同,治理手段也不同。
  • 交付变慢、覆盖率下降、告警增加、缺陷上升、理解成本变高,是可观测的五个信号。
  • 重写、维持、重构、投资各有适用边界,选择依据是投入产出比。
  • 落地靠共识、可见、止损、复盘四步循环,而不是一次性的清理行动。
最近更新: 2026/11/20 22:16
Contributors: 庆峰
Prev
企业架构:故障管理与分级响应
Next
Python 数据分析:员工分布可视化