Spring 4 與 Jackson 版本衝突解決方案

問題背景

在整合 Activiti 工作流並調用 Modeler 界面時，發現 Spring 4.x 與項目中較舊版本的 Jackson 庫（jackson-dataformat-xxx）存在類衝突，導致頁面無法正常加載。

根因分析

• Spring 4 內部依賴較新的 Jackson 版本（通常 2.4+）。
• 項目原引用的 Jackson 版本過低（如 1.9.x 或 2.0.x），API 不兼容導致 NoSuchMethodError 或 ClassNotFoundException。
• 常見衝突點：ObjectMapper 配置、日期格式化、模塊註冊等 API 變更。

解決步驟

1. 統一版本： 在 Maven dependencyManagement 中鎖定 Jackson 版本（建議 2.9.x 或 2.10.x，與 Spring 4 兼容）。
2. 排除傳遞依賴： 在引入 Spring 或 Activiti 依賴時，<exclusion> 掉舊版 jackson-core、jackson-databind、jackson-annotations。
3. 全量升級： 將項目中所有 jackson-* 模塊（core, databind, annotations, dataformat-xml, datatype-jdk8 等）升級至同一版本。
4. 重新編譯部署： mvn clean install -U 強制更新快照，驗證 Modeler 頁面正常渲染。

最佳實踐

• 使用 mvn dependency:tree 定位版本衝突路徑。
• 優先選擇 Spring Boot 管理的版本（若遷移至 Boot），或參考 Spring Framework BOM。
• 保持 Jackson 核心三模塊（core, databind, annotations）版本號一致。