解決jackson-databind升級後的還原序列化失敗

本文說明如何解決AEM Sites表單中升級jackson-databind後發生的還原序列化失敗,尤其是當參照移除的PropertyNamingStrategy$SnakeCaseStrategy類別時。

說明 description

環境

  • Adobe Experience Manager (AEM)網站
  • jackson-databind 2.20或更新版本

問題/症狀

  • 在AEM Sites中載入表單時發生錯誤。
  • 錯誤訊息包含參照com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy的TypeNotPresentException。
  • 如果將Jackson用於JSON還原序列化的Servlet端點參考移除的類別,則會在執行階段失敗。

原因

PropertyNamingStrategy$SnakeCaseStrategy類別在jackson-databind 2.12中已過時,在2.20中已移除。 升級至jackson-databind 2.20或更新版本後,參考此類別的任何程式碼都會失敗。

解決方法 resolution

若要解決移除PropertyNamingStrategy$SnakeCaseStrategy所導致的AEM Sites表單還原序列化錯誤,請遵循下列步驟:

  1. 搜尋您的程式碼基底,以取得com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy的任何參考。

  2. 以PropertyNamingStrategies$SnakeCaseStrategy取代PropertyNamingStrategy$SnakeCaseStrategy的所有使用方式(請注意plural形式)。

    • 舊: com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy
    • 新增: com.fasterxml.jackson.databind.PropertyNamingStrategies$SnakeCaseStrategy
  3. 檢閱您的程式碼基底,瞭解從jackson-databind 2.20和更新版本中任何其他已棄用或移除的常數或類別,並將其更新為其支援的同等專案。

  4. 確保您的建置組態中包含jackson-databind以及「提供的」範圍,以避免與平台發生版本衝突。

  5. 將更新後的程式碼部署至您的AEM環境。

  6. 確認TypeNotPresentException不再出現在記錄中,且表單已如預期般載入。

recommendation-more-help
experience-cloud-kcs-help-kbarticles