jar包冲突,jar包隔离(转)

转自:https://blog.csdn.net/qq_37527921/article/details/102839369

最近项目需要使用jar包隔离技术,所以了解了几种方案,本文针对几种不同方案进行了介绍,不同问题有各自合适的方案,正在解决类似问题的同学可以通过本文快速了解jar包隔离的几种技术。

面临问题

  • 你们的组件包带了一堆乱七八糟的依赖jar,跟我的jar冲突了啊
  • 怎么天天ClassNotFound、NoSuchMethod
  • 怎么有好几个不同版本的jar包,不管了,先用着再说
  • 厂商不同,同时对接统一组件的不同版本怎么搞,某一厂商还fork了自己的版本,这不麻烦吗

通常自己写代码是,大家都忽略这些问题了,但是当项目越大,需要对接的业务越多时,这些问题就日益严重了, 这时候,就需要对jar包进行统一管理了,可以统一组件jar包版本,也可以容器化隔离方案。今天就给大家介绍一下解决jar包冲突的几种方式。

解决方案

归纳了解了几种业内的解决方案如下,各有优劣

  1. spring boot方式,统一管理各个组件版本,简洁高效,但遇到必须使用不同版本jar包时,就不行了
  2. OSGI技术,用容器对jar包进行暴露和隔离,实际上是通过不同classload加载类来达到目的,真正的jar包隔离,还能做模块化,服务热部署,热更新等,缺点就是太重了。
  3. sofa-ark 用FatJar技术去实现OSGI的功能,jar包隔离原理上跟osgi一致,不过基于fat jar技术,通过maven 插件来简化复杂度,比较轻量,也支持服务热部署热更新等功能。
  4. shade 也有maven插件,通过更改jar包的字节码来避免jai包冲突,jar包冲突的本质是类的全限定名(包名+类名)冲突了,通过全限定名不能定位到你想用的那个类,maven-shade插件可以更改jar包里的包名,来达到解决冲突的目的。
  5. 自己定义classload,反射调用冲突方法,代码量太大,不通用,但是会帮助理解上面组件的原理。

此外,还有一些其他解决的方式,比如java 9 模块化,提供了一种新的打包方式来解决类冲突、gradle 组件、代码内嵌等。

原理介绍

想要理解jar包隔离,就要了解java的类加载机制,先看下基础知识

类加载

加载指的是将类的class文件读入到内存,并为之创建一个java.lang.Class对象,也就是说,当程序中使用任何类时,系统都会为之建立一个java.lang.Class对象。类的加载由类加载器完成,类加载器通常由JVM提供,这些类加载器也是前面所有程序运行的基础,JVM提供的这些类加载器通常被称为系统类加载器。除此之外,开发者可以通过继承ClassLoader基类来创建自己的类加载器。

类加载器

类加载器负责加载所有的类,其为所有被载入内存中的类生成一个java.lang.Class实例对象。一旦一个类被加载如JVM中,同一个类就不会被再次载入了。正如一个对象有一个唯一的标识一样,一个载入JVM的类也有一个唯一的标识。在Java中,一个类用其全限定类名(包括包名和类名)作为标识;但在JVM中,一个类用其全限定类名和其类加载器作为其唯一标识。例如,如果在pg的包中有一个名为Person的类,被类加载器ClassLoader的实例kl负责加载,则该Person类对应的Class对象在JVM中表示为(Person.pg.kl)。这意味着两个类加载器加载的同名类:(Person.pg.kl)和(Person.pg.kl2)是不同的、它们所加载的类也是完全不同、互不兼容的,所以是通过这个机制来实现类隔离的,sofa-ark实际上也是定义了不同的classload来加载不同的模块,进而实现类隔离
在这里插入图片描述

JVM预定义有三种类加载器,当一个 JVM启动的时候,Java开始使用如下三种类加载器:

根类加载器(bootstrap class loader):

它用来加载 Java 的核心类,是用原生代码来实现的,并不继承自 java.lang.ClassLoader(负责加载$JAVA_HOME中jre/lib/rt.jar里所有的class,由C++实现,不是ClassLoader子类)。由于引导类加载器涉及到虚拟机本地实现细节,开发者无法直接获取到启动类加载器的引用,所以不允许直接通过引用进行操作。

下面程序可以获得根类加载器所加载的核心类库,并会看到本机安装的Java环境变量指定的jdk中提供的核心jar包路径:

public class ClassLoaderTest {

public static void main(String[] args) {
URL[] urls = sun.misc.Launcher.getBootstrapClassPath().getURLs();
for(URL url : urls){
	System.out.println(url.toExternalForm());
}

}

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7

}
运行结果:
在这里插入图片描述

扩展类加载器(extensions class loader):

它负责加载JRE的扩展目录,lib/ext或者由java.ext.dirs系统属性指定的目录中的JAR包的类。由Java语言实现,父类加载器为null。

系统类加载器(system class loader):

被称为系统(也称为应用)类加载器,它负责在JVM启动时加载来自Java命令的-classpath选项、java.class.path系统属性,或者CLASSPATH换将变量所指定的JAR包和类路径。程序可以通过ClassLoader的静态方法getSystemClassLoader()来获取系统类加载器。如果没有特别指定,则用户自定义的类加载器都以此类加载器作为父加载器。由Java语言实现,父类加载器为ExtClassLoader。

类加载器加载Class大致要经过如下8个步骤:

检测此Class是否载入过,即在缓冲区中是否有此Class,如果有直接进入第8步,否则进入第2步。
如果没有父类加载器,则要么Parent是根类加载器,要么本身就是根类加载器,则跳到第4步,如果父类加载器存在,则进入第3步。
请求使用父类加载器去载入目标类,如果载入成功则跳至第8步,否则接着执行第5步。
请求使用根类加载器去载入目标类,如果载入成功则跳至第8步,否则跳至第7步。
当前类加载器尝试寻找Class文件,如果找到则执行第6步,如果找不到则执行第7步。
从文件中载入Class,成功后跳至第8步。
抛出ClassNotFountException异常。
返回对应的java.lang.Class对象。

类加载机制

JVM的类加载机制主要有如下3种。

全盘负责:所谓全盘负责,就是当一个类加载器负责加载某个Class时,该Class所依赖和引用其他Class也将由该类加载器负责载入,除非显示使用另外一个类加载器来载入。
双亲委派:所谓的双亲委派,则是先让父类加载器试图加载该Class,只有在父类加载器无法加载该类时才尝试从自己的类路径中加载该类。通俗的讲,就是某个特定的类加载器在接到加载类的请求时,首先将加载任务委托给父加载器,依次递归,如果父加载器可以完成类加载任务,就成功返回;只有父加载器无法完成此加载任务时,才自己去加载。
缓存机制:缓存机制将会保证所有加载过的Class都会被缓存,当程序中需要使用某个Class时,类加载器先从缓存区中搜寻该Class,只有当缓存区中不存在该Class对象时,系统才会读取该类对应的二进制数据,并将其转换成Class对象,存入缓冲区中。这就是为很么修改了Class后,必须重新启动JVM,程序所做的修改才会生效的原因。

在这里插入图片描述
查询缓存的方法:
查询缓存的方法都是native方法,每个classload都有自己的缓存。
当类加载请求到来时,先从缓存中查找该类对象,如果存在直接返回,如果不存在则交给该类加载去的父加载器去加载,倘若没有父加载则交给顶级启动类加载器去加载,最后倘若仍没有找到,则使用findClass()方法去加载

/*Returns the class with the given binary name
 if this loader has been recorded by the Java virtual machine as an initiating loader of a class with that binary name.
*/
返回具有给定二进制名称的类
如果Java虚拟机已将此加载程序记录为具有该二进制名称的类的初始加载程序。
每个class都有一个引用指向加载它的classload,当name这个类是通过当前classload加载的时,会返回true,JDK内置的类除外(JDK的类虽然为bootstrap classload 加载,但有时这个方法也返回true

private native final Class<?> findLoadedClass0(String name);

这个findBootstrapClass方法是个native的方法,它是去获取BootStrapClassLoader里面加载的类是否有这个类,有的话,说明这个类已经被bootStrapClass加载了,
private native Class<?> findBootstrapClass(String name);

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

classload中的两个重要方法

loadclass 方法:加载方法,双亲委托的实现,自定classload时一般不需要继承
findclass方法: 空,需要子类继承,自定义从URL或jar包等搜索类的方法
当继承URLclassload 自定义 classload时,自定义的classload 只会加载指定URL中的类,JDK的类还是由bootstrap,app 等classload加载,JDK的类不会加载多份,所以不同类加载器之间的类,可以用JDK的数据类型传递数据。

 
  • 1
  • 2
  • 3

了解了上面这些,来看下几种方案解决类冲突的原理:
当两个class全限定名一样时,jvm中只能有其中一种class,这也是由于jvm类加载机制决定的,所以要同时加载两个class,就要打破双亲委托,通过定义新的classload来加载另一种class,避免冲突,因为class loader不光是加载类,还规定了命名空间,不同的class loader加载的类是不同的,即使类的全限定名相同(正因为这样才会有同一个类的多版本支持的技术)。sofa-ark就是通过这种方,通过一些配置就可以实现这种另一种方式就是更改class的全限定名,使两个class可以被同一个classload加载,maven-shade就是通过这种方式。

方案介绍

sofa-ark

使用方法及具体demo 可以去看这篇文章
https://juejin.im/post/5b6b982451882569fd2898d7
需要注意几点 ,如果plugin 和 biz 都在编译器的同一个工作空间的话,运行 biz 时需要将 plugin 删除,否则,maven 会自动引入 plugin 项目而不是 jar 包,就达不到jar包隔离的目的了。
SofaArkBootstrap.launch(args);容器启动函数要在main方法第一句

sofa-ark 框架支持单独application 和 sofaboot 两种方式,满足单独使用和web框架下的jar包隔离,还能基于zk 完成服务热部署等高大上的功能,但是配置方式略复杂。很不幸我的应用是跑在spark里的,做不到将容器启动函数放在main的第一句,因为本来就在spark的容器里了,所以此种方案pass。

shade

在这要感谢https://stanzhai.site/blog/post/stanzhai/%E4%BC%98%E9%9B%85%E5%9C%B0%E8%A7%A3%E5%86%B3Spark-Application-jar%E5%8C%85%E5%86%B2%E7%AA%81%E9%97%AE%E9%A2%98这篇文章的作者,让我了解到了shade方式的jar包隔离,这是一种取巧的方式,并没有定义不同的classload,而是通过更改jar包的字节码,避免jar包内package的名字相同,带来的问题就是,有反射方式调用jar包内方法时,反射部分的代码也要修改,虽然这种方式看起来没有sofa-ark高端,但是生产力高啊,不需要复杂的配置,需要更改的代码也不多,所以我采用了这种方式。下面是对kafka jar包shade的一个样例

  1. 首先建立一个工具工程引入需要shade jar 包
  2. 配置 maven-shade插件,通过 pattern shadedPattern属性来配置要更改的包的名字
  3. 使用shade 后的jar包,import 更改后的包名字,若有反射调用,也反射更改后的包名字
   
  <dependencies>
&lt;dependency&gt;
  &lt;groupId&gt;com.test&lt;/groupId&gt;
  &lt;artifactId&gt;kafka_2.11-0.10.0.1&lt;/artifactId&gt;
  &lt;version&gt;1.0&lt;/version&gt;
&lt;/dependency&gt;

  &lt;dependency&gt;
  &lt;groupId&gt;com.test&lt;/groupId&gt;
  &lt;artifactId&gt;kafka-client-0.10.0.1&lt;/artifactId&gt;
  &lt;version&gt;1.0&lt;/version&gt;
&lt;/dependency&gt;

//kafka的依赖太多,这是单独提出需要shade的两个jar 并发布到本地库后引入

</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.2.1</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>shade</goal>
</goals>
<configuration>
<minimizeJar>true</minimizeJar>

          &lt;relocations&gt;
            &lt;relocation&gt;
              &lt;pattern&gt;org.apache.kafka&lt;/pattern&gt;    需要替换的包的名字
              &lt;shadedPattern&gt;org.apache.tc_kafka&lt;/shadedPattern&gt;     替换后的名字     
            &lt;/relocation&gt;
            &lt;relocation&gt;
              &lt;pattern&gt;kafka&lt;/pattern&gt;     需要替换的包的名字
              &lt;shadedPattern&gt;tc_kafka&lt;/shadedPattern&gt;    替换后的名字  支持通配符可以将包名中所有含kafka的替换为tc_kafka
            &lt;/relocation&gt;          
          &lt;/relocations&gt;
                       
        &lt;/configuration&gt;
      &lt;/execution&gt;
    &lt;/executions&gt;
  &lt;/plugin&gt;
&lt;/plugins&gt;

</build>

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52

使用maven打包发布后可得到shade之后的jar包
原始kafka jar包
在这里插入图片描述
shade后的kafka jar包
在这里插入图片描述
使用shade 后的jar包消费

import  org.apache.tc_kafka.clients.consumer.KafkaConsumer;
......
 props.put("key.deserializer", "org.apache.tc_kafka.common.serialization.StringDeserializer");  
 props.put("value.deserializer", "org.apache.tc_kafka.common.serialization.StringDeserializer");  
......
其他部分跟正常消费一致

 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
自定义classload

此种方式是基础,实现jar包隔离根本的方式,但是一般很少用这种方法,反射调用方法的代码量太大,下面是一个反射调用kafka消费的样例,自定义classload引入了jar包进行消费,跟main 函数使用不同的classload,在其他地方使用不同版本的kafka jar包也就不会引起冲突。
也可使用接口编程,需要隔离的类继承一个接口,通过接口调用方法,不用反射降低代码量,比如jdbc,封装的connection,statment,resultSet接口,加载不同版本的jar包,对接不同的数据库

package com.tc.kafka.test;

import java.io.BufferedWriter;
import java.io.File;
import java.io.FileWriter;
import java.io.IOException;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Collection;
import java.util.Collections;
import java.util.Comparator;
import java.util.HashMap;
import java.util.Iterator;
import java.util.List;
import java.util.Map;
import java.util.Properties;
import java.util.concurrent.Executors;
import java.util.concurrent.ScheduledExecutorService;
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicLong;

import com.sun.org.apache.bcel.internal.generic.NEW;

public class Copy1_consumer_sub {

public static void main(String[] args) throws IOException, InterruptedException, IllegalArgumentException, IllegalAccessException, ClassNotFoundException, NoSuchMethodException, SecurityException, InvocationTargetException, NoSuchFieldException, InstantiationException {
	Properties props = new Properties();
	props.put("bootstrap.servers", "*****");
	props.put("key.deserializer", "org.apache.kafka.common.serialization.ByteArrayDeserializer");
	props.put("value.deserializer", "org.apache.kafka.common.serialization.ByteArrayDeserializer");
	props.put("group.id", "1023");
	props.put("auto.offset.reset", "earliest");
	props.put("acks", "1");
	props.put("retries", "10");
	props.put("batch.size", "10");
	props.put("linger.ms", "50");
	props.put("buffer.memory", "33554432");
	// props.put("max.request.size", "20971520");
	props.put("request.timeout.ms", "35000");
	props.put("session.timeout.ms", "30000");
	props.put("heartbeat.interval.ms", "100");
	props.put("fetch.max.wait.ms", "3000");
	props.put("max.block.ms", "10000");
	props.put("fetch.message.max.byte", "10000");
	props.put("fetch.max.bytes", "10000");
	props.put("enable.auto.commit", "false");

	File file = new File("E:\\eclipse_2019_workspace\\kafka\\lib\\kafka-clients-0.10.0.1.jar");
	File file1 = new File("E:\\eclipse_2019_workspace\\kafka\\lib\\kafka_2.11-0.10.0.1.jar");

	ClassLoader classLoader = new URLClassLoader(new URL[] { file.toURL(),file1.toURL() },
			Copy1_consumer_sub.class.getClassLoader());
	String KafkaConsumer_n = "org.apache.kafka.clients.consumer.KafkaConsumer";
	String ConsumerRecord_n = "org.apache.kafka.clients.consumer.ConsumerRecord";
	String ConsumerRecords_n = "org.apache.kafka.clients.consumer.ConsumerRecords";
	String Utils_n="org.apache.kafka.common.utils.Utils";
	Class KafkaConsumer_c = Class.forName(KafkaConsumer_n,true,classLoader);
	Class ConsumerRecord_c = Class.forName(ConsumerRecord_n,true,classLoader);
	Class ConsumerRecords_c = Class.forName(ConsumerRecords_n,true,classLoader);
    Class utils_c=Class.forName(Utils_n,true,classLoader);
    Method getContextOrKafkaClassLoader=utils_c.getMethod("getContextOrKafkaClassLoader", null);
    

	Constructor KafkaConsumer_p = KafkaConsumer_c.getConstructor(Properties.class);

	Thread.currentThread().setContextClassLoader(classLoader);
	System.out.println(classLoader);
	System.out.println(getContextOrKafkaClassLoader.invoke(utils_c, null));
	System.out.println(Copy1_consumer_sub.class.getClassLoader());
	
	
	Object consumer = KafkaConsumer_p.newInstance(props);

	Method subscribe = KafkaConsumer_c.getMethod("subscribe", Collection.class);
	subscribe.invoke(consumer, Arrays.asList("topic_1029"));
	Method pool = KafkaConsumer_c.getMethod("poll", long.class);

	Field value = ConsumerRecord_c.getDeclaredField("value");
	value.setAccessible(true);


	while (true) {

		Iterable ConsumerRecords = (Iterable) pool.invoke(consumer, 100);

		for (Object object:ConsumerRecords) {
			System.out.println("----");
			System.out.println(new String((byte[]) value.get(object)));
		}

	}

}

}

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103

解决问题

以上是我了解的jar包隔离方案,大家可以根据自己遇到的问题,选择合适的方案,有更好的方案也可以评论交流

借鉴了以下文章,感谢
https://stanzhai.site/blog/post/stanzhai/%E4%BC%98%E9%9B%85%E5%9C%B0%E8%A7%A3%E5%86%B3Spark-Application-jar%E5%8C%85%E5%86%B2%E7%AA%81%E9%97%AE%E9%A2%98
https://blog.mythsman.com/post/5d29b12c373f140fc98304a1/
原文链接:https://blog.csdn.net/m0_38075425/article/details/81627349
链接:https://juejin.im/post/5b6b982451882569fd2898d7