周一早上的站会,组长把一份文件甩到了群里,只有一个名字:OrderController.php。

下面跟了一行字:"3127 行。谁愿意接一下?"

群里安静了三秒。然后所有人都在打字:"我可以看看""我来吧""有没有历史背景"。

我接了。原因很简单——这个文件我改过三次,每次改完都要回滚一次。

先搞清楚它到底有多糟

打开文件的第一件事,不是动手改,而是先量化。

我写了个脚本统计:

总行数 3127
public 方法 41 个
单个方法最长 268 行(createOrder)
内部 include 的其他文件 6 个
包含的业务域:订单创建、支付回调、退款、库存扣减、优惠券、发票、物流、对账、导出、消息推送

十个业务域塞在一个类里。任何一个需求改动,都要在这三千行里找位置。最要命的是,改 A 业务的时候,很容易不小心碰到 B 业务的逻辑,因为很多方法是互相调用的,变量也是共用的。

我在纸上画了一张依赖图,画到一半就放弃了——线太密了,画出来像一团毛线。

结论:这不是重构,这是拆解。我不指望能优雅地"优化"它,我的目标是把它拆成十个能独立呼吸的模块,让后面接手的人不至于每次都提心吊胆。

第一步:先不碰代码,只做盘点

我花了一整个下午做一件事:把 41 个方法按业务域分类,写进一张表。

表格有四列:方法名、调用方、被调用方、所属业务域。

"被调用方"这一列最关键。它告诉我哪些方法是"公共底座",哪些是"业务专属"。

比如 getOrderSn()、formatMoney()、validateParams() 被十几个方法调用,它们属于底座,拆的时候要优先抽出去,不然会出现循环依赖。

而 handleRefund()、buildInvoice()、syncLogistics() 只在各自业务里被调用,拆起来很干净。

这张表写完,我心里就有底了:3127 行里,真正复杂的不是业务逻辑,而是这些逻辑被揉在一起的耦合。

第二步:定拆解方案

我定的方案是"自上而下分三层":

第一层:公共工具

把纯函数、格式化、参数校验、SN 生成这些没有业务含义的代码抽到 core/order/Helper.php。这层没有依赖,最安全,先做。

第二层:数据访问

把所有直接的 SQL 抽到 core/order/Repository.php。原来 Controller 里到处都是 DB::fetch、DB::query,散在几十个方法里。抽出来之后,所有表操作集中在一处,以后加索引、改字段、加缓存,都只改一个地方。

第三层:业务服务

按业务域拆成 8 个 Service 类:OrderCreateService、PaymentService、RefundService、StockService、CouponService、InvoiceService、LogisticsService、ReportService。

每个 Service 只依赖 Repository 和 Helper,Service 之间尽量不互相调用;必须互相调用的(比如创建订单要扣库存),通过明确的方法契约走,而不是直接摸对方的内部状态。

Controller 变成什么?只剩参数接收、调用 Service、返回结果。理想情况下每个方法不超过 30 行。

第三步:动手,一天拆一层

我给自己定了节奏,一天只干一层,每层做完就提交,跑一遍测试。绝不一口气改完再说,那样出了问题根本定位不到。

Day 1:抽 Helper

这一层最轻松。原文件里有一批方法一眼就能看出是工具性质的:

// 订单号生成
private function genOrderSn() { ... }

// 金额格式化(分转元)
private function money($cents) { ... }

// 手机号脱敏
private function maskPhone($phone) { ... }

// 参数必填校验
private function requireParams($params, $keys) { ... }

我把它们全部搬进 Helper,原类里改成调用 Helper 的静态方法。这一步改了 47 处调用点,用 IDE 的重构功能基本能自动完成,手工核对了二十几处。

提交之后跑了测试,全绿。第一天结束,文件从 3127 行降到 2860 行。降得不多,但地基打好了。

Day 2:抽 Repository

这一天最枯燥,但也最有价值。

我数了一下,原文件里有 83 处直接的数据库操作。有的在方法开头查,有的在中间查,有的在末尾更新。SQL 语句是手拼的字符串,字段名散落在各处。

抽 Repository 的过程有点像搬家:把每一处 SQL 都搬到一个具名的方法里。搬完之后,原来的调用变成这样:

// 之前
$order = DB::fetch("SELECT * FROM " . DB::t('orders') . " WHERE order_sn=? AND status=1", [$sn]);

// 之后
$order = OrderRepository::findBySn($sn, 1);

这一步做完,我发现了好几个潜在问题:

有三处查询漏了 status 条件,会把已取消的订单当有效订单读出来;
有一处 UPDATE 没有加 WHERE 的主键条件之外的限定,理论上可能误更新;
有两处重复查询同一个订单,一次查询结果没用上,白跑了一次数据库。

这些问题平时根本看不见,因为散在三千行里没人会去通读。抽到 Repository 集中之后,一眼就能看出来。

这也是重构真正的价值:重构不只是让代码好看,它会让原本藏着的 bug 自己浮出来。

Day 3 到 Day 7:拆 Service

后面五天才真正开始拆业务。我按依赖强弱排序,先拆最边缘的(发票、物流、报表),最后拆最核心的(订单创建、支付)。

这一步遇到了三个坎:

坎一:共享状态

原来的类里有一堆成员变量,比如 $this->currentOrder、$this->userId,在方法之间传来传去。拆成 Service 之后,这些状态不能存在实例上,只能当参数往下传。

我的做法是引入一个轻量的 OrderContext 对象,把一次业务流程里要用的上下文(用户、订单、金额、时间戳)打包传下去。这样每个 Service 都是无状态的,可以随时复用、可以单测。

坎二:回调里的逻辑

支付回调那块原来是"一个方法干完所有事":验签、更新订单、扣库存、生成授权、发消息、写日志,全在一个 200 多行的 handleCallback() 里。

拆的时候我把它改成一条流水线:PaymentService::verify() → OrderService::markPaid() → StockService::deduct() → LicenseService::generate() → MessageService::send()。

每一步都是幂等的——重复执行不会产生重复业务。这一点特别重要,因为支付回调本来就可能重复推送。

坎三:旧代码还在被别的地方调用

拆到一半我发现,另有两个接口文件还在直接调用 OrderController 的私有方法(通过反射,历史遗留)。这就不能直接删方法,得留兼容层。

我的处理是:在新 Service 里保留同名方法作为转发,旧调用继续能用,同时加注释标注"待迁移",排进下个迭代的技术债清单。不做,但也绝不让它悄悄烂在那里。

结果

七天之后,最终形态:

OrderController.php:从 3127 行 → 340 行
剩下 12 个 public 方法,每个平均 26 行,最长的 41 行。

新增 9 个文件
1 个 Helper、1 个 Repository、1 个 Context、8 个 Service——其中两个 Service 合并了(发票和报表共用一个)。

测试
重构前后跑同一套回归测试,功能路径 100% 通过。另外补了 14 个单元测试,主要针对拆分出来的 Service,因为现在它们终于可以独立测试了。

顺带修掉的 bug
3 个查询条件缺失、1 处可能误更、2 处重复查询、还有 1 处订单状态判断写反了(这个比较严重,属于"金额已经付了但状态判成待支付")。

几点体会

第一,重构前先量化。如果我只是凭感觉说"这个文件太乱了",没人会重视。但我说"3127 行、41 个方法、单方法最长 268 行、囊括十个业务域",组长当天就批了工时。

第二,一天一层,绝不贪多。三千行的重构,最大的风险不是改错,而是改完之后出了问题定位不到。分层提交、每层跑测试,出了问题能精确回退到某一天。

第三,重构会帮你发现 bug。这一点我原来不信。这次真的信了——很多问题不是代码写错了,而是写的时候没人看得见。把代码搬到一起,问题就自己站出来了。

第四,别追求"完美拆分"。我拆到一半的时候纠结过:某个方法该放 Service 还是 Repository?某个公共逻辑该抽还是不该抽?纠结了两个小时之后我放弃了:拆解的目标是让代码更容易被理解和修改,不是画一张漂亮的架构图。能说清楚、改得动,就够了。

最后说一句:这个文件在我手上之前,已经换过三个负责人。每个人都说"先这样吧,以后再说"。

这次我没说"以后再说"。七天时间,不长。而现在,下一次接这个文件的人,打开它看到的是 340 行和 9 个职责清晰的文件,而不是 3127 行的迷宫。

这大概就是"技术债"最好的还法——不是抱怨它,是一次还清一小块。