專案 JAR 包選型與版本衝突解決最佳實踐

核心原則

1. 統一版本鎖定：建立專案級 dependencyManagement (Maven) 或 platform (Gradle) 鎖定所有第三方庫版本，禁止子模組自行聲明版本。
2. Classpath 順序可控：Eclipse .classpath / IDEA 模組依賴順序決定同名類別載入優先級。**建議將統一庫目錄置於最前**，或用 Maven/Gradle 強制傳遞依賴解析。
3. 排除傳遞依賴衝突：mvn dependency:tree / gradle dependencies 檢視衝突，<exclusion> 排除舊版傳遞依賴。
4. 配置檔案隔離：多模組專案中，各模組配置檔 (xml/yaml/properties) **不要同名**，或用 spring.config.location 明確指定載入順序，避免重複載入導致 Bean 覆蓋/任務重複執行。
5. 斷點驗證實際載入 JAR：在關鍵類別建構子/靜態區塊設斷點，觀察 ClassLoader 實際載入的 JAR 路徑，確認版本。

實戰流程

1. 建立 lib-managed 目錄，放置**經測試相容的單一版本 JAR**。
2. 所有模組 compileOnly files('lib-managed/*.jar') 或 Maven system scope 參考（或發布至私有 Nexus/NPM）。
3. 編譯期通過 → 啟動期驗證（斷點/日誌輸出 JAR 版本）→ 功能測試。
4. 遇到衝突**必須深入原始碼** 確認根因（如類別重複、SPI 實現衝突），不可憑感覺試錯。

工具推薦

• Maven Enforcer Plugin：建構時強制檢查版本衝突、禁止 SNAPSHOT。
• Gradle Dependency Locking：gradle dependencies --write-locks 生成鎖定檔，保證可重現建構。
• OWASP Dependency Check：掃描已知漏洞版本。