Java 遺留系統重構實戰：從單體大泥球到多模組微服務化架構演進

現狀痛點

• 10+ 年歷史，單一倉庫，十幾個產品共用代碼，包名隔離（`com.company.productA`...）。
• 產品間相互調用混亂，三個基礎產品被所有業務強依賴。
• 前端資源混雜，公共接口（如用戶選擇器）硬編碼大量 `if-else` 分支，維護地獄。

重構總綱：大刀闊斧，分階段交付

Phase 1：建構依賴治理體系

• 引入 **Maven 多模組** 或 **Gradle**，每個產品獨立模組，基礎產品發布為獨立 Artifact（`product-core-api`, `product-core-impl`）。
• 強制**依賴方向單一**：業務模組 → 基礎模組，嚴禁反向/環狀依賴。用 `mvn dependency:analyze` / ArchUnit 單測守護。
• 建立**私有 Maven 倉庫**，版本語義化，基礎模組發布流程自動化。

Phase 2：公共接口「策略模式 + 工廠」重構

以用戶選擇器為例：

// 1. 定義統一介面
public interface UserSelector {
    List select(SelectContext ctx); // 封裝通用參數
    boolean supports(ProductType type);
}

// 2. 各產品實現
@Component
public class ProductAUserSelector implements UserSelector {
    public boolean supports(ProductType type) { return type == ProductType.A; }
    public List select(SelectContext ctx) { /* A 產品專屬邏輯 */ }
}

// 3. 工廠路由
@Service
public class UserSelectorFactory {
    private final Map selectors = new EnumMap<>(ProductType.class);
    @Autowired
    public UserSelectorFactory(List list) {
        list.forEach(s -> Arrays.stream(ProductType.values())
            .filter(s::supports).forEach(t -> selectors.put(t, s)));
    }
    public UserSelector get(ProductType type) { return selectors.get(type); }
}

// 4. 調用端
UserSelector selector = factory.get(currentProductType());
List users = selector.select(context);

**收益**：新增產品只需加實現類，零修改舊代碼，符合開閉原則。

Phase 3：前端資源拆分與共享

• **公共 UI 庫**：提取通用組件、樣式、工具函數發布為 NPM 包（`@company/ui-kit`）。
• **各產品獨立前端工程**：各自 `package.json` 依賴 UI 庫，構建產物部署到對應靜態資源服務/CDN。
• **微前端過渡期**：若暫不能完全拆分，用 `qiankun`/`single-spa` 實現運行時隔離，路由級加載子應用。

Phase 4：服務化拆分與治理

• 核心業務能力暴露為 **Dubbo/gRPC/Spring Cloud** 服務，定義契約接口（Protobuf/Avro）。
• 引入 **註冊中心**、**配置中心**、**鏈路追蹤**、**限流熔斷**（Sentinel/Resilience4j）。
• 數據庫拆分：按業務邊界拆 Schema/實例，跨庫事務用 Seata/事件最終一致性。

關鍵成功因素

1. 高層意志與資源投入：重構是工程項目，非技術任務，需專項組、專項預算、容忍短期產出下降。
2. 測試安全網：特性分支 + 契約測試 + 回歸測試全自動化，無測試不重構。
3. 灰度發布與回滾預案：流量染色、雙寫驗證、一鍵回滾。
4. 文檔與知識傳承：架構決策記錄（ADR）、接口文檔自動生成、新人於boarding。

**切記**：不徹底的重構比不重構更危險。要么不動，動則徹底。