駱俊武@IT人的職場進(jìn)階

讀完需要

7

分鐘

速讀僅需 3 分鐘

前亞馬遜工程師，現(xiàn) 58 轉(zhuǎn)轉(zhuǎn)技術(shù)總監(jiān)，持續(xù)分享個人的成長經(jīng)歷，希望為你的職場發(fā)展帶來些新思路

經(jīng)典著作《重構(gòu)》這本書中有這么一段話：

一開始，我所做的重構(gòu)都停留在細(xì)枝末節(jié)上。隨著代碼趨向簡潔，我發(fā)現(xiàn)自己可以看到一些設(shè)計層面的東西了，這些是我以前理解不到的，如果沒有重構(gòu)，我達(dá)不到這種高度。

重構(gòu)，著實是一件讓程序員興奮的事情。

今年年初，我們團(tuán)隊完成了一個復(fù)雜項目的重構(gòu)工作，它屬于廣告系統(tǒng)最核心的引擎部分，大概有 300 多個文件，3 萬多行代碼。從技術(shù)方案設(shè)計到最終全量上線僅僅花了 1 個月左右的時間，而且沒有產(chǎn)生事故。這應(yīng)該是我 8 年程序生涯中，經(jīng)歷過的最大型的同時最成功的一次重構(gòu)項目：速度足夠快、計劃比較周全、質(zhì)量過關(guān)。

1

? ?

先聊聊這個系統(tǒng)的歷史包袱

我們的廣告引擎在這次重構(gòu)前大概經(jīng)歷了 1 年半時間的迭代，初期針對的是搜索場景，業(yè)務(wù)單一，流程清晰。

2019 年開始，公司的廣告業(yè)務(wù)開始快速擴(kuò)張，收入幾乎是指數(shù)級的增長。在這個過程中，我們的廣告引擎面臨了兩個挑戰(zhàn)：

業(yè)務(wù)場景開始變得復(fù)雜，除了搜索廣告，還需要支持信息流推薦以及相似推薦場景。

廣告流量開始快速增加，除了滿足功能性需求，還需要兼顧好性能。

經(jīng)過梳理，整個引擎有大部分邏輯是可以公用的，因此我們定義了一個主體框架，同時將可擴(kuò)展部分進(jìn)行了抽象。這樣，各個場景能夠根據(jù)自身業(yè)務(wù)的特殊性實現(xiàn)某些公共接口即可。另外，從性能角度考慮，我們犧牲了一些代碼可讀性，把某些邏輯并行化了。

隨著業(yè)務(wù)的發(fā)展，搜索場景開始進(jìn)入快速迭代期，新增策略越來越多，我們的主體框架也是在這個時候逐漸變得不靈活。

如果動主體框架，搜索以外的場景都需要跟著重構(gòu)。在業(yè)務(wù)的快速發(fā)展期，工期根本不允許，因此我們只能在現(xiàn)有框架上進(jìn)行補(bǔ)丁式的開發(fā)。這樣，帶來了兩個很明顯的問題：

為了兼容搜索的特殊邏輯，我們需要在其他場景中增加各種 if 判斷來繞過這些邏輯。

廣告策略越來越多，累計了幾十個，當(dāng)框架失去清晰的結(jié)構(gòu)后，有些策略的實現(xiàn)開始變得定制化，缺少層次化的劃分和可插拔式的抽象設(shè)計。

在這樣的背景下，隨著改動的積累，代碼開始偏離了設(shè)計的初衷，技術(shù)債務(wù)越來越重。但是，我們又始終找不到合適的時機(jī)進(jìn)行重構(gòu)。

轉(zhuǎn)機(jī)出現(xiàn)在 2019 年年底，由于廣告業(yè)務(wù)的特殊性，流量開始自然走低，另外產(chǎn)品運(yùn)營團(tuán)隊將重心放在了第 2 年的工作規(guī)劃上，因此給了我們非常好的窗口期開始此次重構(gòu)。

我們將工期定成了 1 個月，最終僅比預(yù)期晚上線了一天，雖然出現(xiàn)了兩個線上問題，但是在灰度期都及時發(fā)現(xiàn)和修復(fù)了，并沒有造成線上事故。

總體來說，這是一次難度頗大并且比較成功的重構(gòu)項目，下面詳細(xì)說一下我從這個項目中吸取到的寶貴經(jīng)驗。

2

? ?

重構(gòu)前，我們做了哪些準(zhǔn)備工作？

這次重構(gòu)的代碼量很大，3 萬多行，而且是廣告系統(tǒng)最核心的引擎部分。啟動前，我們能預(yù)期到下面這些困難：

業(yè)務(wù)側(cè)的阻力：廣告是極其以業(yè)務(wù)為導(dǎo)向的，本次重構(gòu)雖然能帶來長期研發(fā)效率的提升，但是沒法直接提升業(yè)務(wù)收益，而且開發(fā)周期不會太短，如何才能得到業(yè)務(wù)同學(xué)的支持？

技術(shù)側(cè)的顧慮：重構(gòu)一旦引起線上事故，公司是有處罰制度的，如何讓大家輕裝上陣？同時，重構(gòu)過程中如果還有非常重的業(yè)務(wù)迭代穿插，交付時間沒人敢保證，質(zhì)量也很難得到控制。

針對這兩方的顧慮，我認(rèn)為下面這幾項工作起到了很關(guān)鍵的作用。讓所有人看到痛點

前面提到：隨著業(yè)務(wù)迭代，我們廣告引擎的主體框架已經(jīng)變得模糊不清，另外幾十個廣告策略散落在不同的業(yè)務(wù)場景中，配置凌亂。

針對這兩個痛點，我們提前 1 個月啟動了現(xiàn)有業(yè)務(wù)的梳理，走讀舊代碼、同時翻閱以前的需求文檔，最終我們將不同場景的核心流程以及廣告策略歸類成了一張清晰的表格。

正是這一張表格，讓技術(shù)和產(chǎn)品第一次很清晰地看到了我們引擎部分的全貌，體會到了業(yè)務(wù)的復(fù)雜度以及當(dāng)前技術(shù)上的瓶頸。

明確重構(gòu)的目標(biāo)和價值

讓所有人感受到痛點后，我們規(guī)劃了本次重構(gòu)的兩個核心目標(biāo)：

主體框架的重構(gòu)：將主流程模塊化，重新定義上下層協(xié)議，確保接口清晰；各層級內(nèi)部也需要做好抽象，具備良好的擴(kuò)展性。

策略靈活可配置：將廣告策略按照業(yè)務(wù)意圖進(jìn)行歸類抽象，策略的執(zhí)行條件動態(tài)可配置，同時策略可任意插拔。

此外，我們將這兩個核心目標(biāo)完成后可帶來的預(yù)期收益進(jìn)行了細(xì)化：

技術(shù)收益：代碼結(jié)構(gòu)更清晰，更容易理解和維護(hù)；可擴(kuò)展性增強(qiáng)，引擎的開發(fā)效率將進(jìn)一步提升。

業(yè)務(wù)收益：策略能做到更細(xì)粒度的配置和擴(kuò)展，對業(yè)務(wù)支持更友好；研發(fā)提效后能進(jìn)一步加快業(yè)務(wù)的迭代速度。

將重構(gòu)的價值同步給大家后，進(jìn)一步提升了所有人的興奮度，讓大家有了更強(qiáng)的動力參與進(jìn)來。

整體節(jié)奏的把控

整體節(jié)奏的把控也是非常重要的一環(huán)，能讓所有人對這件事情有一個時間上的預(yù)期。

首先，我們將工期定成了 1 個月，一方面考慮了業(yè)務(wù)側(cè)可以接受的最大周期，技術(shù)上也希望速戰(zhàn)速決；

另一方面，春節(jié)即將來臨，我們必須趕在公司封網(wǎng)前上線，同時預(yù)留出 1-2 周的 buffer 以防意外情況發(fā)生。

此外，我們和業(yè)務(wù)側(cè)達(dá)成了一致：重構(gòu)期間，引擎部分的非緊急需求一律不接，這樣可最大限度地減少并行開發(fā)和代碼沖突，讓團(tuán)隊精力更集中。

3

? ?

執(zhí)行過程中有哪些可分享的經(jīng)驗？

這次重構(gòu)能夠?qū)嵤┑萌绱隧樌?#xff0c;有 4 點我認(rèn)為很有價值的經(jīng)驗跟大家分享下。

3.1

? ?

高質(zhì)量的技術(shù)設(shè)計方案

這一點得益于日常的要求，針對開發(fā)周期超過 3 天的項目我們都會進(jìn)行技術(shù)方案設(shè)計，本次重構(gòu)當(dāng)然也不例外。

框架部分的整體架構(gòu)、模塊之間的協(xié)議設(shè)計、以及策略的可擴(kuò)展性設(shè)計是本次技術(shù)方案的重點，團(tuán)隊前后討論了不下 3 次。

在大方案定稿后，團(tuán)隊進(jìn)一步對數(shù)據(jù)庫、接口字段、緩存結(jié)構(gòu)、日志埋點等公共部分進(jìn)行了細(xì)化，因為涉及到多人協(xié)作開發(fā)，團(tuán)隊約定以文檔作為溝通界面，文檔始終保持和代碼同步。

在這樣的高要求下，團(tuán)隊產(chǎn)出了 5000 多字的技術(shù)方案文檔，合計 36 頁，這些為整體質(zhì)量的保障打下了很好的基礎(chǔ)。

3.2

? ?

預(yù)重構(gòu)出框架性代碼

這一個 PR 非常關(guān)鍵，是我們從技術(shù)方案落地到代碼最重要的一步。我們把重構(gòu)后的包結(jié)構(gòu)、模塊劃分、各層之間的 API 定義、不同廣告策略的抽象進(jìn)行了梳理，先忽略實現(xiàn)的細(xì)節(jié)。

這樣主體代碼基本成型，能很清楚地描繪出我們理想中的框架。然后，我們組織了多次集中代碼審查，最終形成了統(tǒng)一意見。

這一步能很好地避免過早陷入實現(xiàn)細(xì)節(jié)，導(dǎo)致主體框架關(guān)注不夠、代碼不穩(wěn)固，后期再返工反而會拖累效率。

3.3

? ?

頻繁溝通和成對代碼 Review 機(jī)制

進(jìn)入到細(xì)節(jié)實現(xiàn)階段后，很重要的一點是：對現(xiàn)有邏輯的理解。引擎代碼經(jīng)過一年半的迭代，歷史上被很多人開發(fā)過，但是本次只有 3 個同學(xué)參與重構(gòu)。

整個過程中，我們遇到任何代碼邏輯不明確的地方，都是反復(fù)溝通和求證，不主觀猜想，這一份謹(jǐn)慎其實很關(guān)鍵。

另外在代碼審查上，我們按模塊分配了對這塊業(yè)務(wù)比較熟悉的同學(xué)來負(fù)責(zé)，成對搭配，機(jī)制靈活。

3.4

? ?

有效的測試方案

重構(gòu)未動，測試先行。這個原則是《重構(gòu)》一書中重點強(qiáng)調(diào)的，也是我們本次技術(shù)方案討論的重點，我這里單獨(dú)拎出來詳細(xì)展開下。

首先，我們前期便約定好：不動任何老代碼，完全建新的 package 進(jìn)行重構(gòu)。這樣方便比對重構(gòu)前后的結(jié)果，同時進(jìn)行線上灰度實驗。

測試方案上，以下 4 點值得借鑒：

端到端測試：本次重構(gòu)不涉及功能性的調(diào)整，因此外層 API 的行為是不會有任何變化的，這樣端到端的測試方法最為有效，這個是研發(fā)和 QA 測試最主要的手段。

冒煙測試：QA 同學(xué)提供冒煙 Case，由研發(fā)同學(xué)進(jìn)行冒煙，研發(fā)提測前必須保證所有冒煙 Case 執(zhí)行通過。這一點在大部分互聯(lián)網(wǎng)公司都不常見，但是對于大型項目絕對有效。

沙箱環(huán)境雙流程驗證：前面提到我們重構(gòu)前后的代碼都保留了，因此可以通過腳本抓取線上環(huán)境的入?yún)⒆鳛?case，然后用自動化的方式對 API 的返回字段進(jìn)行逐一比對。

線上環(huán)境灰度實驗：灰度對于重構(gòu)非常重要，我們利用已有的 ABTest 平臺，逐步放開灰度流量，從 5%、到 10%、到 30%、最后到 100%，制定了很謹(jǐn)慎的放量節(jié)奏，然后通過日志以及業(yè)務(wù)指標(biāo)監(jiān)控進(jìn)行驗證。

4

? ?

寫在最后

回顧整個重構(gòu)的過程，總結(jié)成下面 7 個關(guān)鍵點：

把握好重構(gòu)時機(jī)

前期梳理很重要，先找到痛點

明確出目標(biāo)和價值，讓大家興奮起來

不宜長線作戰(zhàn)，不宜和業(yè)務(wù)并行

需要高質(zhì)量的技術(shù)方案

重構(gòu)未動，測試先行

小心求證，為每行代碼負(fù)責(zé)

當(dāng)然，最關(guān)鍵的因素還是人，大型項目重構(gòu)極其考驗團(tuán)隊的協(xié)作能力，如果每個人都很靠譜，重構(gòu)就已經(jīng)成功了一半。

- EOF -

想要加入中生代架構(gòu)群的小伙伴，請?zhí)砑尤汉匣锶?strong>大白的微信

申請備注（姓名+公司+技術(shù)方向）才能通過哦！

精彩文章推薦：

找CTO杜仲：再談中年危機(jī)和應(yīng)對策略

阿里高級技術(shù)專家張建飛：面對復(fù)雜業(yè)務(wù)，if-else coder 如何升級？

阿里專家常昊：新人如何上手項目管理？

螞蟻集團(tuán)沈凋墨：Kubernetes-微內(nèi)核的分布式操作系統(tǒng)

快狗打車CTO沈劍：如何利用計劃管理提升團(tuán)隊效率和產(chǎn)能

阿里合伙人范禹：常掛在阿里技術(shù)人嘴邊的四句土話

阿里技術(shù)專家都鐸：一文搞懂技術(shù)債

Mobvista首席架構(gòu)師蔡超：工作感悟之失敗與成功，我的8點總結(jié)

奈學(xué)教育CEO孫玄：成為一個有情懷的工程師，我的12點思考

蘇寧智能 BU大數(shù)據(jù)中心數(shù)據(jù)治理團(tuán)隊負(fù)責(zé)人韋真：數(shù)據(jù)治理“三字經(jīng)”，超實用！

阿里高級技術(shù)專家簫逸：如何畫好一張架構(gòu)圖？

阿里巴巴閑魚架構(gòu)負(fù)責(zé)人王樹彬：萬億交易規(guī)模技術(shù)架構(gòu)實踐

阿里高級技術(shù)專家張建飛：應(yīng)用架構(gòu)分離業(yè)務(wù)邏輯和技術(shù)細(xì)節(jié)之道

? ?END ? ?? #架構(gòu)師必備#感謝您的一鍵三連 點分享點點贊點在看

總結(jié)

以上是生活随笔為你收集整理的58 转转技术总监骆俊武：一个核心系统 3 万多行代码的重构实战篇的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。