JAVA Spring Boot maven导入使用本地SDK（jar包）
JAVA Spring Boot maven导入使用本地SDK（jar包）
在 Java Spring Boot 项目中，如果你需要通过 Maven 引入一个本地的 SDK（jar 包），可以通过以下两种方式实现：
✅ 方法一：使用 system作用域（推荐用于本地测试）
1. 配置说明
- 使用
<scope>system</scope>和<systemPath>指定本地 jar 包路径。 - 注意：
systemPath必须是绝对路径或基于${project.basedir}的相对路径。
2. 示例配置
<dependency><groupId>com.xiaohongshu.fls</groupId><artifactId>xiaohongshu-sdk</artifactId><version>1.0.0</version><scope>system</scope><systemPath>${project.basedir}/lib/xiaohongshu-sdk.jar</systemPath>
</dependency>
📁 假设你的本地 jar 包放在项目根目录下的
lib/文件夹中。
3. 目录结构建议
your-project/
├── pom.xml
└── lib/└── xiaohongshu-sdk.jar
4. 注意事项
system作用域依赖不会被 Maven 打包进最终的 jar/war，不推荐用于生产环境。- 适合本地调试或快速验证。
✅ 方法二：安装 jar 包到本地 Maven 仓库（推荐用于正式开发）
1. 安装命令
mvn install:install-file -Dfile=lib/xiaohongshu-sdk.jar \-DgroupId=com.xiaohongshu.fls \-DartifactId=xiaohongshu-sdk \-Dversion=1.0.0 \-Dpackaging=jar
将
lib/xiaohongshu-sdk.jar替换为你的 jar 包路径。
注意：DgroupId、DartifactId，都是可以自定义的。
2. 配置依赖
安装完成后，直接在 pom.xml 中声明依赖即可：
<dependency><groupId>com.xiaohongshu.fls</groupId><artifactId>xiaohongshu-sdk</artifactId><version>1.0.0</version>
</dependency>
3.执行
执行 mvn clean install 即可成功引入 SDK。
4. 优点
- 更符合 Maven 标准，支持打包、部署、依赖传递。
- 可以通过
mvn clean install构建整个项目。
🔁 方法三：使用 <dependencyManagement> 统一管理版本（可选）
如果你有多个模块需要使用该 SDK，可以在父 pom.xml中统一管理版本：
<dependencyManagement><dependencies><dependency><groupId>com.xiaohongshu.fls</groupId><artifactId>xiaohongshu-sdk</artifactId><version>1.0.0</version></dependency></dependencies>
</dependencyManagement>
然后在子模块中只需声明依赖即可，无需指定版本：
<dependency><groupId>com.xiaohongshu.fls</groupId><artifactId>xiaohongshu-sdk</artifactId>
</dependency>
🧪 验证是否成功
运行以下命令查看依赖是否生效：
mvn dependency:tree
如果输出中包含：
[INFO] +- com.xiaohongshu.fls:xiaohongshu-sdk:jar:1.0.0
说明 SDK 已成功引入。
📝 总结对比
| 方法 | 适用场景 | 是否推荐 | 说明 |
|---|---|---|---|
system 作用域 | 本地快速测试 | ⚠️ 不推荐用于生产 | 不会打包进最终 jar |
| 安装到本地仓库 | 正式开发 | ✅ 推荐 | 更符合 Maven 规范 |
<dependencyManagement> | 多模块统一管理 | ✅ 推荐 | 可提升可维护性 |