手动引入JAR的坑

2022-05-31 15:50:12

在项目开发的过程中，会有很多需求需要进行拓展，一般非特殊情况的话。我们都会引入第三方的工具包进行处理。（这个场景是公司采购了一批第三方代码，这面先运行起来。前期减少改动，所以直接使用提供的jar，进行依赖了。）

这种情况就容易出现工具包间的相互依赖，如果其中部分工具包进行了常规升级，则会导致不兼容的情况发生，下面我就举例说明一下，最近发生在我身上的依赖Bug解决流程。

前景是：最近项目需要手动引入一个jar。在配置pom文件后

<dependency>
            <groupId>xxx</groupId>
            <artifactId>xxx</artifactId>
            <version>2.0</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/xxx.jar</systemPath>
        </dependency>

使用的时候出现下面异常信息：

java.lang.NoClassDefFoundError: Could not initialize class xxxx.class] with root cause

从上面理解为未找到对应class文件导致无法初始化类。

但是类是通过jar引入的应该不存在这个问题啊。

需要继续往上找发现下面的异常日志（第一次出现问题应该提示的下面的信息。之后提示的是上面的信息）

java.lang.NoClassDefFoundError: com/fasterxml/jackson/databind/jsontype/PolymorphicTypeValidator] with root cause

发现是jar 包中需要 jackson相关依赖，但是本地项目的jackson版本较低，没有相应类。所以我准备升级一下本地jackson依赖。但是启动项目的时候出现无法启动异常。

Connected to the target VM, address: '127.0.0.1:xxxxx', transport: 'socket'

怀疑是升级jackson会对其他依赖的文件产生影响，比如spring我们使用的版本就比较低。

放弃这种方法，只能从jar包中入手了。

查看jar包中信息，排查到下面的代码出现的问题

ObjectMapper OBJECT_MAPPER = new ObjectMapper() {
        private static final long serialVersionUID = -5640476057715217573L;
        {
            this.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
            this.activateDefaultTyping(LaissezFaireSubTypeValidator.instance, DefaultTyping.EVERYTHING, JsonTypeInfo.As.WRAPPER_OBJECT);*/
        }
    };

下面这段代码出现的问题，jackson ObjectMapper 中的 enableDefaultTyping 方法由于安全原因，从 2.10.0 开始标记为过期，建议用 activateDefaultTyping 方法代替，所以如果继续使用 enableDefaultTyping 会有警告出现，我们现在要消除这个警告，去看一下 enableDefaultTyping 源码（注意 @deprecated 信息）.

为了解决目前的问题，所以先将这部分内容降版本，重写下

ObjectMapper OBJECT_MAPPER = new ObjectMapper() {
        private static final long serialVersionUID = -5640476057715217573L;
        {
            this.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
            this.enableDefaultTyping(ObjectMapper.DefaultTyping.NON_FINAL);
            //objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
            /*this.activateDefaultTyping(LaissezFaireSubTypeValidator.instance, DefaultTyping.EVERYTHING, JsonTypeInfo.As.WRAPPER_OBJECT);*/
        }
    };

重新更改jar中的依赖，打包后覆盖之前的位置上，重启服务，解决了这个问题。

这个例子是依赖版本降级使用，升级也同样适用的。

一般如果使用的大众一些的工具包，在其升级版本的时候都会注明一些方法替换内容。

所以遇到类似问题，可以先尝试阅读源码来找到对应替换内容。

码农公寓

相关文章