解决jackson-databind升级后的反序列化故障

本文说明如何解决在升级jackson-databind之后发生的AEM Sites表单中的反序列化失败,尤其是当引用删除的PropertyNamingStrategy$SnakeCaseStrategy类时。

描述 description

环境

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

问题/症状

  • 在AEM Sites中加载表单时出错。
  • 错误消息包括引用com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy的TypeNotPresentException。
  • 如果使用Jackson for 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. 将PropertyNamingStrategy$SnakeCaseStrategy的所有使用情况替换为PropertyNamingStrategies$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