首页 > 编程语言 >SpringBoot项目引入本地JAR包详细步骤

SpringBoot项目引入本地JAR包详细步骤

来源：互联网 2026-07-23 08:03:08

在SpringBoot项目中引入本地JAR包有两种主流方式：一是利用Maven的system作用域并配置spring-boot-maven-plugin的includeSystemScope；二是将JAR包安装到本地Maven仓库后通过常规依赖引入。前者简单直接，适合快速集成；后者更符合标准依赖管理，便于团队协作和跨环境部署。

摘要

在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等自定义位置，便于集中管理依赖。

SpringBoot项目引入本地JAR包详细步骤

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、artifact ID和版本号即为上述指定值。

2. POM引入

安装完成后，在pom.xml中即可像正常依赖一样引用，无需再写systemPath：


    com.aspose
    aspose-words
    14.9.0-jdk16

这样，Maven在构建时将从本地仓库找到该JAR包，打包时也会自动包含。

总结

两种方法各有优劣：方法一直接简单，适合快速集成一两个本地JAR包；方法二需多一步安装操作，但更符合Maven的标准依赖管理逻辑，在团队协作或跨环境部署时更可靠。需注意，system作用域的方式虽然方便，但若项目需迁移至其他环境（如CI/CD服务器），或与其他依赖发生版本冲突，管理起来较为棘手。因此，条件允许时，优先考虑将JAR包上传至内部私有仓库，走标准引入路径。对于临时测试或封闭环境，本地引入完全够用，按上述步骤操作即可顺利运行。

侠游戏发布此文仅为了传递信息，不代表侠游戏网站认同其观点或证实其描述