Meta 逃脫 WebRTC 分支陷阱，透過雙堆疊架構現代化 50+ 使用案例

Meta 逃脫 WebRTC 分支陷阱，透過雙堆疊架構現代化 50+ 使用案例。

Meta 工程團隊分享如何擺脫「分支陷阱」（forking trap），在單一程式庫內同時建置舊版與上游最新版 WebRTC，支援 50+ 使用案例的 A/B 測試，並建立持續升級工作流程，提升效能、二進位大小與安全性。

分支陷阱的挑戰

在 monorepo 環境中分支大型開源專案如 WebRTC，初期僅為內部最佳化或快速修復，但隨著上游演進與內部功能累積，合併外部變更的資源需求變得難以負荷。Meta 曾開發高性能 WebRTC 變體，服務全球 Messenger、Instagram 影片聊天、低延遲 Cloud Gaming 及 Meta Quest VR 轉播等，支援數十億使用者，但長期分支導致與上游脫節，無法獲取社群升級。

升級風險高，尤其在服務數十億使用者時，單次升級可能因裝置與環境多樣性導致使用者體驗中斷，且難以回滾。monorepo 無功能分支支援，傳統 patch 檔案順序套用方式不具擴展性，C++ 靜態連結違反 One Definition Rule (ODR)，產生數千符號衝突。

雙堆疊架構與 Shim 層

為實現 A/B 測試，Meta 建置 shim 層作為應用程式與 WebRTC 間的代理程式庫，提供單一版本無關的統一 API。應用程式呼叫 shim API，shim 依「風味」（flavor）配置在執行時轉發至舊版（webrtc_legacy）或最新上游版（webrtc_latest）。

此設計避免高層呼叫協調程式庫重複導致的 38 MB 未壓縮大小增加，僅新增約 5 MB，減少 87%。shim 層透過模板輔助程式庫處理版本轉發，共用邏輯僅寫一次，版本特定行為用 C++ 模板特化實現，支援單風味建置的向後相容。

解決符號衝突

靜態連結雙版本產生數千重複符號，Meta 開發自動命名空間重寫腳本，將 webrtc:: 改為 webrtc_latest:: 或 webrtc_legacy::，涵蓋所有外部命名空間。全球 C 函式、自由變數及命名空間外類別則移入命名空間或附加風味特定識別符。

巨集如 RTC_CHECK、RTC_LOG 在包裝程式庫外使用導致重定義錯誤，解決策略包括：

• 移除多餘包含。
• 重命名少用巨集。
• 跨版本共用內部模組如 rtc_base，減少二進位大小與 shim 範圍。

向後相容與風味轉發

全符號命名空間重寫會破壞外部呼叫點，Meta 先用前向宣告轉接新舊命名空間，但產生龐大脆弱標頭檔。最終採用 C++ using 宣告大量匯入風味命名空間至熟悉的 webrtc::，僅需簡潔標頭，新符號自動處理，無二進位大小影響，使用者程式碼無需變更。

執行時轉發用方向適配器（directional adapters）實現統一 API 至底層 WebRTC，或反向；方向轉換器（directional converters）處理結構與列舉轉譯。全球風味枚舉在應用程式啟動早期設定，決定啟用版本。

自動化 Shim 生成

手動建置數十 API 的適配器、轉換器與單元測試耗時龐大，Meta 開發基於抽象語法樹（AST）解析的程式碼生成系統，自動產生類別、結構、列舉與常數的基準 shim 程式碼，完整單元測試且易擴充。速度從每日一 shim 提升至三至四個，簡單相同 API 幾乎無需手動介入；複雜案例如 API 差異、工廠模式、靜態方法、原始指標語意與物件擁有權轉移，則由工程師精煉。

建置與測試雙堆疊應用

重接線應用程式參照，從直接 WebRTC 類型轉為 shim 等價物（如 webrtc::Foo 至 webrtc_shim::Foo），處理物件擁有權、空值與記憶體管理風險，透過複製擁有權轉移情境的全面單元測試及高風險差異的端到端測試緩解。

迭代建置從小目標擴大，浮現缺失 shim、不正確風味物件、新巨集或符號衝突。內部注入元件依賴 WebRTC 內部，無法 shim，改用 C++ 巨集與 Buck 建置機制動態變更命名空間、重複高層建置目標，單一標頭暴露雙風味符號。

最終內部與部分外部應用建置運行雙風味音訊影片通話，新增逾 10,000 行 shim 程式碼，修改數十萬行跨數千檔案，經嚴格測試與審核無重大問題。

功能分支追蹤 Patch

monorepo 無分支，Meta 在獨立 Git 儲存庫追蹤功能分支，基於 libwebrtc Git 儲存庫，重用 Chromium 工具（gn、gclient、git cl）。每個上游 Chromium 版本如 M143（git tag 7499）建「base/7499」分支，每個 patch 如「debug-tools」建「debug-tools/7499」分支。

升級時合併前進，如 debug-tools/7499 至 debug-tools/7559，所有分支解決衝突後順序合併成發行候選分支 r7559。優點包括高度平行化、保全 Git 歷史、適合未來潛在的 LLM 驅動自動衝突解析，便於整支分支貢獻上游開源。

升級成果與工程勝利

雙堆疊二進位從 M120 推出 webrtc/latest 至 M145，擺脫多年落後，立即採用最新穩定 Chromium 發行。關鍵改善：

• 效能：主要應用 CPU 使用降最多 10%，崩潰率改善最多 3%。
• 二進位大小：上游版更高效，視應用壓縮後減 100-200 KB。
• 安全性：移除過時程式庫如 usrsctp，修復舊版堆疊漏洞。

這些驅動使用者參與度提升，證明 monorepo 環境下無需全寫重構即可現代化技術債。此專案由 Dor Hen、Guy Hershenbaum、Jared Siskin、Liad Rubin、Tal Benesh、Yosef Twaik 等工程師共同完成，展現創意解決複雜 monorepo 限制，提供逃脫分支陷阱的藍圖。