摘要
在Spring Boot项目中，时常需要引入本地JAR包，例如公司内部的自定义库或缺乏公开Maven坐标的第三方工具。本文系统梳理了两种主流实现方式：一是直接利用Maven的system作用域，并配合spring-boot-maven-plugin配置；二是将JAR包安装到本地Maven仓库后，通过常规依赖引入。两种方案均已验证可行，最后将探讨各自的适用场景与注意事项，帮助开发者快速选择合适方法。
引言
Spring Boot本身提供了丰富的开箱即用功能，但在实际开发中，难免需要对接一些“本土”库——可能是团队自封装的工具包，也可能是供应商提供的SDK。此时，将JAR包直接塞入项目往往是最直接的做法。
当然，能走Maven中央仓库或私有仓库是最理想的，但有些场景下（如不想公开、临时测试），本地JAR包反而更灵活。不过，本地引用也有其陷阱，比如打包时依赖丢失、环境迁移困难等。下面将从两种具体方法入手，逐步梳理完整流程，同时指出常见踩坑点。
在Spring Boot项目中引入本地JAR包，常见的有两种方式：
方法一：本地jar包导入项目
1. 将JAR包复制到项目目录
先将需要引入的本地JAR包放置到项目目录下，例如放在src/main/resources/lib等自定义位置。这样所有依赖集中管理，便于维护。
2. 在POM文件中添加依赖
打开pom.xml，按如下方式声明依赖，关键是将scope设为system，并指定systemPath指向实际路径：
supermap supermap.data 11.1.1 system ${pom.basedir}/src/main/resources/lib/com.supermap.data.jar supermap supermap.realspace 11.1.1 system ${pom.basedir}/src/main/resources/lib/com.supermap.realspace.jar
其中${pom.basedir}代表项目根目录，后续路径为JAR包相对于项目根的位置。注意路径必须正确，否则Maven会报错。
仅配置依赖还不够，若直接打包，system作用域的依赖默认不会被包含。需要额外配置spring-boot-maven-plugin，将includeSystemScope设为true：
org.springframework.boot spring-boot-maven-plugin true
此配置的含义是：打包时将system作用域的依赖一并纳入。若不添加此行，本地JAR包在运行时将提示找不到类。
方法二：将jar包安装至本地仓库后使用pom文件直接引入
另一种思路是先将本地JAR包“安装”到本地Maven仓库，之后再像普通依赖一样引用。其优势在于后续依赖管理更标准，且无需担心打包问题。
1. jar包安装到本地maven仓库
使用Maven安装命令，将JAR包注册到本地仓库。命令格式如下：
mvn install:install-file -Dfile=jar包的位置 -DgroupId=上面的groupId -DartifactId=上面的artifactId -Dversion=上面的version -Dpackaging=jar
举例说明，假设有一个aspose-words的JAR包位于本地路径：
mvn install:install-file -Dfile=E:workworkspaceIDEAlkp-report-factorysrcmainresourceslibsaspose-words-14.9.0-jdk16.jar -DgroupId=com.aspose -DartifactId=aspose-words -Dversion=14.9.0-jdk16 -Dpackaging=jar
执行成功后，该JAR包会被复制到本地Maven仓库的对应目录中，组ID、artifactId和版本号即上述指定值。
2. pom引入
安装完成后，在pom.xml中即可像常规依赖一样引用，无需再写systemPath：
com.aspose aspose-words 14.9.0-jdk16
这样，Maven在构建时会从本地仓库获取该JAR包，打包时也会自动包含。
总结
两种方法各有千秋：方法一直接、简单，适合快速集成一两个本地JAR包；方法二虽然多了一步安装操作，但更符合Maven的标准依赖管理逻辑，在团队协作或跨环境部署时更为可靠。需要提醒的是，system作用域的方式虽然方便，但一旦项目需要迁移到其他环境（如CI/CD服务器），或发生版本冲突，管理起来会相对棘手。因此，若条件允许，建议优先将JAR包上传至内部私有仓库，走标准引入路径。对于临时测试或封闭环境，本地引入完全够用，按上述步骤操作即可顺利运行。
