问问助手

遗留系统改造决策手册

2026-09-25 Aryee 54

这是「遗留系统改造」六篇长文的压缩版,只留下评审会上能对着念的部分:怎么算过关、要列哪些东西、清单怎么填。每个判断的来龙去脉,在每节末尾提到的长文里。

用法很简单:立项之前看第 1 节和第 2 节;交付之前看第 4 节、第 6 节;感觉项目要失控,翻第 5 节。

一、第一关:流量能不能分批放出去

每个入口都要有一个你能改的收口点,比如网关、服务之间的路由、定时任务的开关。没有统一入口的系统没法分批,只能一次全换。

这一关问的不是风险大不大,而是有没有下手的地方。

二、第二关:改前改后能不能比

要有一种办法,把同一个输入分别喂给新系统和老系统,拿到两份能摆在一起看的输出。

这套比对能力必须排在动手之前建,不能边改边补。

三、第三关:数据能不能退

每一次写操作都要有说清楚的回退点。做法是先扩后收,加上双写;在回退点消失之前,把读的那一侧换到新库。

数据是改造里唯一退不回去的东西,这一关不过,前面两关都白搭。

四、三关都没过,还能不能开工

三条都过不了还坚持开工,结局在立项那天就写好了。「不改」在门槛不过的时候是一个合法结论。

另一种合法写法是:先做运维层面的止血,改造另外立项。这句话要写进会议记录,不要停在口头。

五、最容易漏的五样约定

盘点的时候,按下面五样逐项问一句「谁在依赖它现在的样子」。每一项都要落到具体名字和代码位置,不能只写一个「有风险」。

第一样,反射与字段名。有人按字符串里的字段名取值,你把驼峰改一下,他那一段就断了。

第二样,按位置解析的字符串。导出文件、报文按第几个逗号取数,你加一列,他那边就乱一次。

第三样,外部直连的库。报表工具、隔壁系统绕开接口直接查库,你改表结构,没有人会通知你。

第四样,时区与精度。用字符串存的时间、截断到分钟的金额,对方依赖的正是这点不标准。

第五样,被写死的错误码。下游把错误码字符串写进了判断里,你换成枚举,当天就出事故。

六、先把老系统的行为录下来

没有测试的老系统,改造期最贵的不是写新代码,是不知道它现在到底在做什么。

挑输入要从真实流量里挑,覆盖到各个分支和边界,不要手写三条顺路的例子。

输出记到能复现差异的那一层就停,记全量日志等于没记。

时间戳、自增 id、序列化顺序这些噪声字段,先做归一化,不抹平的话,差异报告全是噪音。

如果是写接口,取证之前先把副作用隔开:影子表、沙箱账号,或者干脆只读旁路。三样都没有,先去建。

比对出差异时,不允许「先不管」。每一处差异要么解释掉,要么挡住上线;解释不了的差异,就是还没找到的 bug。

七、数据改造的四步,各自会在哪儿出事

先扩后收。收缩要推迟到旧系统退役之后再动;提前删列,回滚的时候无处可退。

双写。四种实现位置的含义不同,选一种,并把一致性要求写清楚;双写出异常只记日志不回滚,两个库会悄悄分家。

对账。线上还在写的时候,「对上了」要说得更具体:差值一路往下走,并且低于事先约定的那个数;拿一个静止的时刻去比,永远对不平。

换读。四步走,要认清回退点从哪一步开始消失;把换读和停写合成一步,出了事只能救数据。

八、放量放的是最多赔多少

一次放给谁、放多少,按「哪一块坏了最疼」来排,不要按百分比排。1% 的流量如果全是同一类写操作,那就不叫灰度。

开关要有主人,也要有到期的那一天。回滚要能当场答出三个问题:数据怎么办、进行中的请求怎么办、谁来验证回滚本身。演练时换一个没参与开发的人来执行。

九、账要算到停手那天

一个批次一个批次地算四笔钱:把现状摸清楚、动手改造、新旧两套同时跑的这段日子、老代码什么时候真删掉。最后这笔最容易被漏。

新旧同时跑的那段日子按天算钱,不要只算人头。立项那天就写下停手的三个条件,条件一到就停,不是再开一次会讨论。

风险登记册可以直接抄成本那篇长文里的模板。

十、验收要过的五关

上线不是改造完成。五关各自要拿出一份能核对的证据,缺一关就是没验收。

行为这一关,回答「改前改后一样吗」,证据是对不上的地方每一条都找到了原因。

数据这一关,回答「数据对得上吗」,证据是对账报告,差值降到约定数值以下,再加抽样复核。

性能这一关,回答「变差了吗」,基线要包含 p95 和 p99,还要看机器忙到什么程度,不能只看平均值。

运维这一关,回答「接手的人管得住吗」,告警、预案、值班手册由接手的那拨人自己走通一遍。

可维护性这一关,回答「没参与过的工程师能改吗」,找一个陌生人改一个小需求,看他卡在哪。

十一、旧代码什么时候才允许真删

最后这一条最常被整段跳过。旧代码不是上线就删,也不是永远留着。标准在验收那篇长文里,这里只提醒一句:删之前,先把「还能不能退回去」这个问题回答完。

十二、评审会上按顺序问八个问题

每个问题都要一个「是或否」,再加负责人和日期。

  1. 三类入口各自汇到哪个地方?改那里配置的权限在谁手里?
  2. 怎么证明改前改后行为一样?这套办法要多久建起来?
  3. 数据改歪了,能退回到哪一步?
  4. 上面那五样约定,各自的依赖方名单出来了吗?
  5. 新旧两套同时跑要跑多久、每天花多少、谁批的?
  6. 停手的那三个条件,数值分别定在多少?
  7. 五关各自的证据由谁出、什么时候出?
  8. 旧代码允许真删的条件是什么?

有六条以上答不出来,这个会就不该批开工。

十三、这份清单的边界

这份手册对应六篇长文的浓缩版,完整论证、样本出处与踩坑细节都在长文里。它不能替你做决定,只能保证评审会上该问的问题没有被漏掉。

需要针对你的系统做一轮诊断,可以走首页的预约入口。

引用这一篇
https://www.aryee.cn/archives/legacy-modernization-field-guide.html

转载或引用请注明出处与链接。

你手上那套系统,卡在哪一步?

留个手机号和方便的时间,我打过来先听你说现状和限制,再给一个能执行的判断:这套系统该继续修、该动哪里,还是重做一版更省。

约一次沟通不接纯 UI 外包,只做系统层面的问题。不方便留号码,也可以直接跟助手说一句话。