实例化ably-java时出现java.lang.NoSuchFieldError: DEFAULT_PACKER_CONFIG错误

Question #

我尝试使用Ably的Java SDK，但在实例化该库时遇到了java.lang.NoSuchFieldError: DEFAULT_PACKER_CONFIG错误。请问这是什么原因？

Answer #

嘿大家好！作为Ably的开发者布道师，这个问题是我日常支持中遇到的高频问题之一，所以特意在这里把根因和解决方案讲清楚。

这个错误几乎百分百是依赖冲突导致的——具体来说是Ably Java SDK依赖的com.fasterxml.jackson系列库版本不匹配。

Ably的SDK是基于特定版本的Jackson来做序列化/反序列化操作的。如果你的项目里同时引入了其他依赖，而这些依赖又拉取了不兼容的Jackson版本，就会导致类路径里混进了不同版本的Jackson模块。Jackson的内部结构在不同版本间会有变更，Ably代码里期望的DEFAULT_PACKER_CONFIG字段，在你项目实际加载的Jackson版本里可能已经不存在或者位置变了，于是就抛出了这个错误。

下面是具体的解决步骤：

• 第一步，先排查项目的依赖树，找出所有引入Jackson的依赖：
  • 如果你用Maven，执行命令：mvn dependency:tree
  • 如果是Gradle，执行命令：./gradlew dependencies
• 第二步，统一项目中Jackson的版本，确保和你使用的Ably SDK版本兼容。对于大部分Ably稳定版SDK，Jackson 2.15.x及以上版本都能正常工作。你可以通过构建工具的依赖管理功能来锁定版本：
  • Maven里可以用<dependencyManagement>区块来固定Jackson各模块的版本
  • Gradle里可以用平台依赖或者force属性来覆盖冲突版本
• 如果有其他依赖拉取了旧版Jackson，直接从该依赖里排除冲突的Jackson模块。举个Maven的例子：

<dependency>
    <groupId>你的项目依赖groupId</groupId>
    <artifactId>冲突的依赖artifactId</artifactId>
    <version>依赖版本号</version>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

等你把项目里的Jackson版本统一对齐后，再实例化Ably SDK时，这个NoSuchFieldError就应该消失了。

内容的提问来源于stack exchange，提问作者Srushtika Neelakantam