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 已成功引入。

📝 总结对比