技术文章 · 读代码
把复杂度留在边界上
三个月前接手的那套服务,最让我意外的不是它混乱,而是它并不混乱——它只是把复杂度放错了地方,于是每一层都显得无辜,合起来却没人说得清一次请求到底经历了什么。
示例内容·可替换:以下正文用于展示版式,请替换为你的真实文章。
接手第一天我做了件很笨的事:把一次下单请求的完整链路抄在纸上。抄到第二十三个箭头的时候,我发现自己写下了三个「这里为什么要判断一次」——三个都在不同层,三个都合理,三个都不知道另外两个存在。
一 · 症状
系统表现得很「稳」:没有大面积报错,监控面板一片绿。可一旦出问题,排查时间长得离谱。原因不是日志少,而是每个组件都只肯说半句话:网关说「请求被拒绝」,服务说「参数不合法」,存储说「前置条件不满足」。三句话拼起来,仍然没人知道是谁先动的念。
二 · 判断散在四层
我把所有校验点列了一遍,按「谁知道什么」重新归类,结果很清楚:同一个业务规则在四层各写了一遍,每层只掌握一部分事实。
- 网关拿得到调用方身份,看不到租户配额。
- 服务层拿得到配额,看不到库存快照的版本。
- 存储层拿得到版本,却不知道这笔单是不是补单。
- 定时任务知道补单,但它的判断发生在十分钟之后。
每一处判断单独看都正确,合起来却构成了一个谁都不负责的整体。这不是代码质量问题,是归属问题。
复杂度不会消失,它只会搬家。你能选的只有:让它集中在一处被人看见,还是散在四处被人忽略。
三 · 收回到边界
改法不复杂:把「这笔单现在能不能过」抽成一个纯函数,输入是它真正需要的四件事,输出是一个带原因的判定。四层不再各判一次,而是各自补齐事实,交给这个函数。
type Facts struct {
Actor Identity // 谁在下单
Quota Quota // 此刻还剩多少
Version SnapshotID // 库存快照版本
Replay bool // 是否补单
}
// Decide 只做判断,不读库、不写库、不重试
func Decide(f Facts) Verdict
这样做的代价是:调用方必须先把事实凑齐,多了一次组装。收益是:出问题时只有一处需要读,而且它可以被单测覆盖——在此之前,这条规则没有任何一处能被单独测试。
四 · 复盘
这次改动一共删掉四百多行,加了不到一百二十行。但我更在意的是另一件事:改动之后,新人问「为什么这单被拒」时,我能给出一个确定的答案,而不是三个都说得通的答案。
后来我给自己定了条规矩:读代码时,凡是遇到「这里为什么要判断一次」,就记一笔;同一类判断出现第三次,就说明它该有个归属了。