Maven打包成Jar文件时依赖包的问题

时间:2021-05-14 18:37:23

我们项目中使用到第三方的库文件,这些jar库文件并没有放到Maven*库上,导致我们需要在项目中自己配置使用。我们的两三个开发人员对Java都是很熟,因此在使用中遇到了一些问题,表现在:在本地中引入第三方jar包后,在Idea中进行相应设置后,可以调试运行了,但是用Docker打包上传到服务器后,运行时会提示找不到某些类的定义。

经查看这些找不到的类就是来自第三方库,那么问题有可能是第三方jar包的路径问题,或者是根本就没有打包进jar文件里面。我们可以去Docker容器内部查看jar文件,执行命令:jar tf xxx.jar|grep lib,其中xxx.jar是打包后生成的文件名称。这个命令打印出jar文件中lib目录下的所有文件,从这里我们可以看到,确实没有包含第三方的jar文件。

在网上找了一阵子,各种说法五花八门,然而都不能解决问题,比如这里有一篇:3-ways-to-add-local-jar-to-maven-project,看着貌似能解决问题,但使用后还是无法解决。比如将第三方jar包安装到本地Maven,这种方式是可以解决本地编译的问题,但我们还得去编译服务器上再安装一遍,而且要指定groupId,artifactId等东西,感觉蛮麻烦。我们只想在编译打包时,把我们的lib文件夹的文件都拷贝到jar文件的lib目录下。有什么办法呀?

Maven中有各种plugin,也就是插件,有人推荐用assembly插件,比如这样写:

<plugin>
    <artifactId>maven-assembly-plugin</artifactId>
    <configuration>
        <descriptorRefs>
         <descriptorRef>jar-with-dependencies</descriptorRef>
        </descriptorRefs>
    </configuration>
</plugin>

我们以为这样就能把所有依赖包放进最终的jar文件中了,可惜试了之后还是不行,其它类似方法也试了都不行。后面想想,是不是要把lib文件夹放到resource目录下。试了之后,发现这回倒是拷贝进jar文件了,但是放置的位置是BOOT-INF/classes/lib里面,而其他的库文件则放到BOOT-INF/lib里面,这样运行时会不会找不到那些第三方jar文件呢?我们没有验证,然后在这里找到一篇文章,解决了拷贝lib目录文件到BOOT-INF/lib的问题,配置如下:

<resources>

<resource>

<directory>src/lib</directory>

<targetPath>BOOT-INF/lib/</targetPath>

<includes>

<include>**/*.jar</include>

</includes>

</resource>

<resource>

<directory>src/main/resources</directory>

<targetPath>BOOT-INF/classes/</targetPath>

</resource>

</resources>

这样之后,所有的依赖包都放到BOOT-INF/lib目录下了,程序也可以正常运行了。

以为到这里能加鸡腿了,结果来个更大的坑。第三方库里面有读取文件的接口,我们在使用接口时,传入了一个配置相关的文件的路径,我们是在resources目录下新建了个目录来存放这个配置文件的。运行时异常:

java.io.FileNotFoundException:

class path resource [aaa/xxx.conf] cannot be resolved to absolute file path because it does not reside in the file system.

这个问题是因为程序去读取文件时,是去文件系统里面找文件,而不是从jar里面找,人家是建议使用getInputStream而不是getFile。可是读取文件的功能是第三方库实现的,我们没法改动读取文件的方式。那怎么办?老老实实在Dockerfile文件加个拷贝操作呗,把配置文件放到文件系统相应目录下即可。

总结一下,这个问题的原因还在于,我们对官方Maven文档不熟,没有研究过各种配置,对Jar文件的组织结构和运行原理不太清楚,因为我们几个Java方面的经验都不够多,踩过的坑还太少,同时也不得不感叹,Java开发里面的各种配置,也真是眼花缭乱啊,即便我们也使用了Spring Boot这种简化了配置的开发框架。

文章来源:技术人成长

欢迎关注公众号:

Maven打包成Jar文件时依赖包的问题