SpringBoot Maven项目部署SAP CF时SAP JCo3初始化失败问题

问题概述 #

部署以WAR包形式、指定TomEE7为运行时的SpringBoot应用至SAP Cloud Foundry时，遇到两类SAP JCo3相关错误：

• java.lang.NoClassDefFoundError: com/sap/conn/jco/JCo : cannot initialize class because prior initialization attempt failed
• java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: no sapjco3 in java.library.path:[/usr/java/packages/lib/amd64, /usr/lib64, /lib64, /lib, /usr/lib] and in system

错误根源 #

1. 第一类错误是JCo类初始化失败的连锁反应：首次尝试初始化JCo时因找不到本地库文件失败，后续类加载请求直接触发该错误。
2. 第二类错误是核心原因：Java虚拟机无法定位SAP JCo3的本地库文件（Linux环境下为sapjco3.so），当前java.library.path中未包含该文件所在路径。

解决方案 #

1. 正确配置SAP JCo3的Maven依赖 #

SAP JCo3的Jar包无法从公共Maven仓库获取，需手动安装到本地仓库或直接引入项目：

• 手动安装至本地仓库（替换版本号和文件路径）：

  mvn install:install-file -Dfile=/本地路径/sapjco3.jar -DgroupId=com.sap.conn.jco -DartifactId=sapjco3 -Dversion=3.1.0 -Dpackaging=jar
  

• 在pom.xml中添加依赖：

  <dependency>
      <groupId>com.sap.conn.jco</groupId>
      <artifactId>sapjco3</artifactId>
      <version>3.1.0</version>
      <!-- 若已安装至本地仓库，可移除systemScope和systemPath -->
      <scope>system</scope>
      <systemPath>${project.basedir}/lib/sapjco3.jar</systemPath>
  </dependency>
  

2. 部署SAP JCo3本地库文件并配置路径 #

Cloud Foundry的TomEE环境不会自动加载自定义本地库，需将Linux版本的sapjco3.so放入项目并配置JVM参数：

• 将sapjco3.so放入项目src/main/resources/lib目录（打包后会被放到WAR包的WEB-INF/classes/lib路径）。
• 在manifest.yml中配置JVM参数，指定本地库路径：

  applications:
  - name: 你的应用名称
    path: target/你的应用包.war
    buildpacks:
      - sap_java_buildpack
    env:
      TARGET_RUNTIME: tomee7
      JAVA_OPTS: "-Djava.library.path=WEB-INF/classes/lib"
  

  或使用SAP Java Buildpack的原生库支持：将sapjco3.so放入项目根目录的native-libs文件夹，Buildpack会自动将该目录加入java.library.path。

3. 调整SpringBoot WAR打包配置 #

确保SpringBoot适配TomEE环境，避免容器冲突：

• 启动类继承SpringBootServletInitializer并重写configure方法：

  @SpringBootApplication
  public class YourApplication extends SpringBootServletInitializer {
      @Override
      protected SpringApplicationBuilder configure(SpringApplicationBuilder application) {
          return application.sources(YourApplication.class);
      }
  
      public static void main(String[] args) {
          SpringApplication.run(YourApplication.class, args);
      }
  }
  

• 在pom.xml中设置打包类型为WAR，并排除内置Tomcat依赖：

  <packaging>war</packaging>
  
  <dependencies>
      <dependency>
          <groupId>org.springframework.boot</groupId>
          <artifactId>spring-boot-starter-web</artifactId>
          <exclusions>
              <exclusion>
                  <groupId>org.springframework.boot</groupId>
                  <artifactId>spring-boot-starter-tomcat</artifactId>
              </exclusion>
          </exclusions>
      </dependency>
      <!-- 添加Servlet API依赖，scope设为provided避免打包冲突 -->
      <dependency>
          <groupId>javax.servlet</groupId>
          <artifactId>javax.servlet-api</artifactId>
          <version>3.1.0</version>
          <scope>provided</scope>
      </dependency>
  </dependencies>
  

4. 验证部署流程 #

• 执行mvn clean package重新打包，解压WAR包确认sapjco3.jar和sapjco3.so已正确包含在对应路径。
• 使用cf push部署应用，通过cf logs 你的应用名称 --recent查看日志，确认无JCo初始化错误。

内容的提问来源于stack exchange，提问作者Athul Ram