18. SpringBoot 如何在 POM 中引入本地 JAR 包

在这里插入图片描述

❤️ 个人主页：水滴技术
🌸 订阅专栏：成功解决 BUG 合集
🚀 支持水滴：点赞👍 + 收藏⭐ + 留言💬

Spring Boot 是一种基于 Spring 框架的轻量级应用程序开发框架，它提供了快速开发应用程序所需的一系列工具和库。在开发 Spring Boot 应用程序时，您可能需要使用本地 JAR 包来添加自定义库或功能。本文将介绍在 Spring Boot 项目的 POM 文件中如何引入本地 JAR 包。

引入本地 JAR 包

在 Spring Boot 项目的 POM 文件中引入本地 JAR 包，您可以使用 system 作用域。system 作用域指定了依赖项需要从本地文件系统中获取，而不是从 Maven 仓库中获取。以下是在 Spring Boot 项目的 POM 文件中引入本地 JAR 包的示例：

<dependency>
  <groupId>com.example</groupId>
  <artifactId>mylib</artifactId>
  <version>1.0</version>
  <scope>system</scope>
  <systemPath>${project.basedir}/src/main/resources/lib/mylib.jar</systemPath>
</dependency>

在上述示例中，<scope> 元素指定了依赖项的作用域为 system。<systemPath> 元素指定了本地 JAR 包的路径，${project.basedir} 变量表示项目根目录的路径。

配置 Maven 插件

通过上面的配置，可以将本地的 JAR 包引入到项目中，但使用范围仅限于本地项目，如果将项目打包到服务器，该 JAR 包也不会被识别的。那是因为，还缺少下面配置：

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

在 Maven 项目的 POM 文件中，<includeSystemScope> 元素用于指定是否在依赖项解析期间包括 system 作用域的依赖项。当设置 <includeSystemScope> 为 true 时，Maven 会在解析依赖项时包括 system 作用域的依赖项；当设置为 false 时，Maven 会忽略 system 作用域的依赖项。

也就是说，增加此配置，JAR 包才能一块被打包到服务器，不加此配置，本地可以运行，但服务器上找不到此 JAR 包。

总结

在 Spring Boot 项目的 POM 文件中引入本地 JAR 包是一项常见的任务。使用 system 作用域和<includeSystemScope> 可以方便地引入本地 JAR 包，但也可能会带来一些潜在的问题，因为 system 作用域的依赖项不是由 Maven 管理的，它们依赖于本地文件系统中的 JAR 文件。如果您需要在不同的机器上部署应用程序，或者本地 JAR 包依赖于其他库，建议您使用 Maven 官方仓库或私有 Nexus 仓库来管理依赖项。