SpringBoot添加外部jar包及打包(亲测有效) - 第452篇

历史文章（文章累计450+）

《国内最全的Spring Boot系列之一》

《国内最全的Spring Boot系列之二》

《国内最全的Spring Boot系列之三》

《国内最全的Spring Boot系列之四》

《国内最全的Spring Boot系列之五》

深入Feign源码吃透Spring扩展点「扩展点实战系列」- 第446篇

利用Spring扩展点对敏感信息加密解密，一文集齐n多知识点「扩展点实战系列」」- 第447篇

利用Spring扩展点模拟MyBatis的注解编程「知识点多多」「扩展点实战系列」- 第448篇

走进MyBatis源码一探Spring扩展点「知识点多多」「扩展点实战系列」- 第449篇

走进SpringBoot源码吃透Spring扩展点「扩展点实战系列」- 第450篇

5个月的精华：Spring/SpringBoot扩展点手册：手册在手，编码无忧：全网独一份 - 第451篇

悟纤：师傅，最近使用spring-boot-maven-plugin导出jar包之后，运行不起来，报ClassNotFoundException。

师傅：那ClassNotFoundException指向的类是Spring Boot starter的类，还是项目中的类，还是？

悟纤：这个类是项目中引入的外部jar包中的类。

师傅：那这样子的话，很有可能就是在打包的时候，外部jar包没有一起被打包进来了，这要解决了这个问题，那么问题就迎刃而解了。

师傅：有些时候，问题并不是很难，我们要学习的就是学习分析问题，然后解决问题，这也是拉开和别人的差距。

悟纤：那师傅我自己去好好研究下~

师傅：去吧，学会分析问题，解决问题，超越自己。

导读

最近在研究web3的时候，有些依赖包，并没有在maven仓库中，需要从git上下载源码，然后编译打包，最后在引入到项目中。

引入使用之后，编译以及在开发工具运行都是很正常的，但打完包之后，一运行就报错了，通常报错是Caused by: java.lang.ClassNotFoundException，所以这一节就来解决一下两个问题：

（1）如何添加外部jar包？

（2）如何打包外部jar包？

题外话：最近把Spring/Spring扩展点实战系列写完之后，就不知道要写哪方面的文章了，大家对什么感兴趣，可以留言~

一、添加外部jar包

准备一个外部jar包，比如api.jar：

在项目路径下创建一个文件夹libs，将api.jar放到libs下。

添加外部jar依赖：

<dependency>    <groupId>com.kfit</groupId>    <artifactId>api</artifactId>    <version>1.0.0</version>    <scope>system</scope>    <systemPath>${project.basedir}/libs/api.jar</systemPath></dependency>

添加完之后，代码中就可以使用到该jar里的类和方法。

说明：

（1）groupI、artifactId、version随便填写，并不一定要和api.jar的信息，但肯定是要一定的规范和关联性会比较好了。

（2）scope=system表示此依赖是来自外部jar，而不是maven仓库。当scope设置为system时，systemPath属性才会生效，systemPath为一个物理文件路径，来指定依赖的jar其物理磁盘的位置。

（3）${project.basedir}代表根目录。

二、打包外部jar包

上面哪一步仅仅是引用到了项目里，打包的时候是不会打包到jar/war中的。对于Spring Boot的项目，一般都会使用到打包插件，那么只需要添加一个配置即可，如下：

<plugin>    <groupId>org.springframework.boot</groupId>    <artifactId>spring-boot-maven-plugin</artifactId>    <configuration>        <includeSystemScope>true</includeSystemScope>    </configuration></plugin>

说明：重要的是includeSystemScope为true。

如果有些配置文件，并非Spring Boot的默认路径，那么可能就需要借助resouce配置（resources节点和plugins节点同级）:

<resources>    <resource>        <!-- directory 表示取该目录下的文件 -->        <directory>libs</directory>        <!--targetPath 指定打包到哪个目录下  默认是放到class目录下-->        <targetPath>/BOOT-INF/lib/</targetPath>        <!-- 取符合格式的所有文件  *代表全部 -->        <includes>            <include>**/*.jar</include>        </includes>    </resource></resources>

总结

（1）如何添加外部jar包：指定score=system，并且配置sysemPath。

（2）如何打包外部jar包：使用spring-boot-maven-plugin，并且配置属性includeSystemScope为true。

最近把Spring/Spring扩展点实战系列写完之后，就不知道要写哪方面的文章了，大家对什么感兴趣，可以留言~