接手 OTTO 项目时,它已经在生产环境跑了四年。代码库约六万行,没有测试,没有文档,核心逻辑集中在一个两千行的 God Class 里。每次发版前,团队都要花两天做手工回归,线上事故平均每月一次。这篇实录记录了从评估到落地的完整过程,包括我们踩过的坑和最终验证有效的做法。
第一步:先量化,再动手
重构最大的风险是凭感觉开工。我们先花了一周做量化评估,产出了三份清单。
- 依赖清单:用静态分析工具扫出模块间的调用关系,标出循环依赖和扇出超过 15 的模块。结果发现支付模块被 23 个文件直接引用,是典型的耦合中心。
- 变更热点清单:拉取近一年的提交记录,统计每个文件的修改频次与缺陷密度。热点集中在订单状态机和优惠券计算两处,这两块占了 60% 的线上缺陷。
- 行为基线清单:在关键入口埋点,记录输入输出样本,为后续重构提供对照基准。这一步后来被证明是整个项目最有价值的投入。
三份清单交叉后,我们确定了改造优先级:先做订单状态机的逻辑抽离,再做支付模块的接口收敛,最后处理全局配置的散落问题。顺序的原则是先改缺陷密度最高、依赖相对独立的模块,快速拿到正反馈。
第二步:用测试锁住行为

遗留项目没有测试,直接改代码等于蒙眼走钢丝。我们的策略是写特征测试,而不是追求覆盖率。
具体做法是:从行为基线中挑出高频路径和边界场景,针对现有代码的实际输出写断言,哪怕输出看起来不合理也照实记录。比如订单金额为负时旧代码返回 0 而不是报错,这个行为被原样固化下来,避免重构中无意改变对外契约。
三周内我们积累了约 180 个特征测试,覆盖了订单、支付、退款三条主链路。这些测试在后续每次提交中自动运行,成了重构的安全网。经验是:特征测试的目标是描述现状,不是描述理想,一旦开始顺手修 bug,范围就会失控。
第三步:小步拆分,保持可发布
我们没有开长期分支,而是坚持每天合并到主干,靠三个手段控制风险。
绞杀者模式替换核心类
对那个两千行的 God Class,做法是在它外面包一层门面,新逻辑写进独立的新类,门面按方法逐个转发。每迁移一个方法,就删掉旧实现并跑一遍特征测试。整个过程持续了六周,期间系统始终保持可发布状态,没有出现大爆炸式合并。
接口收敛用适配层过渡
支付模块有七套风格各异的调用方式,我们没有一次性统一,而是先定义一套内部标准接口,再为旧调用方写适配器。新代码只走标准接口,旧代码逐步迁移。适配层是临时设施,我们在代码里显式标注了计划删除的日期,防止它变成新的技术债。
配置集中化分两批走
散落在各处的配置项先统一收拢到一个配置类,但读取入口暂时保留旧路径,等所有调用方切换完成后再删除旧入口。两批之间隔了一个发布周期,给线上问题留出观察窗口。
第四步:用数据验证效果

重构结束三个月后,我们对比了改造前后的指标:线上缺陷从月均一次降到季度一次;发版前的手工回归从两天压缩到半天,因为主链路已由自动化测试覆盖;新增一个订单状态的平均改动文件数从 9 个降到 2 个。这些数字比任何主观评价都更有说服力,也是向管理层汇报时最有力的材料。
几条事后总结的经验
- 不要为了重构而重构。每个改造动作都要对应一个可度量的问题,否则很容易陷入无休止的代码美化。
- 特征测试优先于单元测试。遗留项目的行为契约比内部结构更重要,先锁住外部行为,再谈内部设计。
- 保持主干可发布。长期分支会让合并成本指数上升,小步提交配合自动化测试是唯一可行的节奏。
- 给临时设施设死期。适配层、门面、兼容入口都要标注删除计划,否则重构只是把旧债换了个位置。
- 让数据说话。缺陷率、回归时长、改动扩散度这些指标既是验证手段,也是争取后续资源的基础。
Otto 的改造没有使用什么高深技术,核心是把一件高风险的事拆成许多件低风险的小事,并用测试和数据把每一步钉死。遗留项目不可怕,可怕的是没有基线就动手、没有验证就宣布成功。















暂无评论内容