解决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表单反序列化错误,请执行以下步骤:
-
在代码库中搜索对
com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy的任何引用。 -
将
PropertyNamingStrategy$SnakeCaseStrategy的所有使用情况替换为PropertyNamingStrategies$SnakeCaseStrategy(请注意plural形式)。- 旧:
com.fasterxml.jackson.databind.PropertyNamingStrategy$SnakeCaseStrategy - 新建:
com.fasterxml.jackson.databind.PropertyNamingStrategies$SnakeCaseStrategy
- 旧:
-
查看您的代码库,了解从jackson-databind 2.20及更高版本中任何其他已弃用或移除的常量或类,并将它们更新为其支持的等效项。
-
确保在构建配置中将jackson-databind包含在“提供的”范围中,以避免与平台的版本冲突。
-
将更新后的代码部署到AEM环境。
-
验证
TypeNotPresentException是否不再出现在日志中,以及是否按预期加载表单。
recommendation-more-help
experience-cloud-kcs-help-kbarticles