接手遗留项目,我先用 AI 做一次代码 Review
摘要:* 没有文档、没有测试、原作者已经离职——这种项目的风险不在"看不懂",在"没看全"。本文记录一次用 AI 代码评审给遗留项目做体检的完整流程:怎么圈定范围、怎么读报告、哪些问题必须先修、修完怎么复验。
一、为什么不是先跑起来
接手一个陌生项目,最常见的动作是先把它跑通:装依赖、改配置、点开首页,看到页面能出来,心里就踏实了一半。
但"能跑通"和"没问题"是两件事。跑得通的代码里,可能藏着拼接的 SQL、写死的密钥、没有边界检查的数组访问。这些不会让程序立刻崩,只会在某个特定输入下爆掉——而那个输入,往往来自线上。
所以我的顺序是反过来的:先静态过一遍,摸清风险分布,再决定要不要动结构。这一步用 AI 代码评审来做,理由很实际——它不困、不烦,几千行代码一次扫完,给出一份按严重程度分级的清单,比人眼翻两天靠谱。
二、四步流程
第一步,圈定范围。
不要一上来就全仓库扫。先按业务链路划分核心模块:登录、支付、数据读写、定时任务。第一轮只扫这几块。
范围小,噪音少,结论能直接用。全仓库扫出来的几百条告警,看着壮观,实际没人处理。
第二步,发起评审。
在码道里打开项目,选中目录后发起一次 Review,让它按安全、性能、可维护性三个维度出报告。目录级评审比单文件评审有用,因为跨文件的调用关系只有放在一起看才成立。
第三步,读报告只看三类。
- 高危:注入、越权、密钥硬编码、任意文件读写
- 高频:重复代码、超长函数、深层嵌套
- 可疑:异常被吞、并发无锁、资源未释放
剩下的先放着。命名不规范、注释缺失这类,记进待办,不要现在动。
第四步,修完立刻复验。
每修完一批就重跑一次评审。这一步不能省——很多时候问题不是被修掉了,是被改到别处去了。
三、一个高危例子
遗留项目里最典型的一类问题,是字符串拼接出来的 SQL:
sql = "SELECT * FROM orders WHERE user_id = " + user_id
cursor.execute(sql)
评审会直接标为注入风险。修法是参数化:
sql = "SELECT * FROM orders WHERE user_id = %s"
cursor.execute(sql, (user_id,))
后者不是"写法更优雅",是"拼不出恶意语句"。输入 user_id = "1 OR 1=1" 时,前者会把整张表交出去,后者只会查不到数据。
这类问题的优先级永远排第一,原因很简单:利用成本极低,一个 URL 参数就够了。
四、哪些问题可以暂时不修
不是所有告警都要当天处理。我的判断标准:
| 类型 | 处理时机 |
|---|---|
| 高危安全问题 | 当天修,没有例外 |
| 影响正确性的并发问题 | 本周修 |
| 重复代码、超长函数 | 跟着业务改动顺手清 |
| 命名、注释、纯风格 | 不动 |
最后一条要说清楚:纯风格问题改了,只会增加 diff 行数,不增加任何安全性。遗留项目最忌讳的就是"顺手大改",改完没人敢 review,风险反而更高。
五、两个坑
坑一:把 AI 的结论当判决。
评审报告是线索,不是结论。它标了"可能存在注入",你要确认这个变量是否真的来自外部输入。有没有可能它来自内部枚举?有可能。误报要自己排掉,别一股脑全改。
坑二:一次修太多。
第一批只修高危,修完复验、提交、再修下一批。一次改三十个文件,出了问题根本定位不到是哪一处引起的。
六、小结
遗留项目的风险不在"看不懂",在"没看全"。AI 评审解决的是覆盖面问题——它替你把每一行都看一遍,但判断还是得自己做。
真正交付给下一个人的,不是"我大概看过了",而是那份分级清单和每一处的处理理由。有了它,下一个人接手时,至少知道哪里埋着雷。
- 点赞
- 收藏
- 关注作者
评论(0)