Spring Boot项目sapjco3.jar依赖报错及集成方案求助

核心思路 #

因为sapjco3.jar明确禁止重命名或二次打包，必须保证它以原文件名被放到BOOT-INF/lib目录里。最直接的方法是把本地的sapjco3.jar配置成Maven依赖，让spring-boot-maven-plugin在打包时自动将其纳入lib目录，全程不修改原Jar文件。

具体实现步骤 #

1. 把本地sapjco3.jar配置为Maven系统依赖 #

在项目的pom.xml里添加系统依赖，直接指向你的sapjco3.jar路径：

<dependencies>
    <dependency>
        <groupId>com.sap.conn.jco</groupId>
        <artifactId>sapjco3</artifactId>
        <version>3.1.0</version> <!-- 版本号随便填，不影响最终Jar文件名 -->
        <scope>system</scope>
        <systemPath>${project.basedir}/../some-module-name/lib/sapjco3.jar</systemPath>
        <optional>false</optional>
    </dependency>
</dependencies>

2. 配置spring-boot-maven-plugin强制包含系统依赖 #

默认情况下spring-boot插件不会打包系统依赖，需要显式开启这个配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <!-- 强制把系统依赖打包进去 -->
                <includeSystemScope>true</includeSystemScope>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>repackage</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

3. 验证打包结果 #

执行Maven打包命令：

mvn clean package

解压生成的可执行Jar，查看BOOT-INF/lib目录，确认sapjco3.jar以原文件名存在，没有被重命名或修改。

替代方案（系统依赖方式受限的情况） #

如果项目不允许用系统依赖，可以先把sapjco3.jar安装到本地Maven仓库，再作为普通依赖引入：

1. 执行本地安装命令：

mvn install:install-file -Dfile=../some-module-name/lib/sapjco3.jar -DgroupId=com.sap.conn.jco -DartifactId=sapjco3 -Dversion=3.1.0 -Dpackaging=jar

2. 在pom.xml里添加常规依赖：

<dependencies>
    <dependency>
        <groupId>com.sap.conn.jco</groupId>
        <artifactId>sapjco3</artifactId>
        <version>3.1.0</version>
    </dependency>
</dependencies>

这种方式下spring-boot插件会自动把它打包到BOOT-INF/lib，同样保留原文件名。

关键注意事项 #

• 务必确认sapjco3.jar的路径配置正确，避免打包时找不到文件
• 绝对不能用maven-shade-plugin或assembly-plugin对这个Jar做重打包操作，否则会触发报错
• 如果用GitHub Actions构建，要确保构建环境能访问到sapjco3.jar（比如把它纳入仓库，或者在工作流里添加下载步骤）

内容的提问来源于stack exchange，提问作者Jonas Boon