在Springboot项目中，如何正确加载FFmpeg和OpenCV的本地库（so文件）？

在springboot项目中，如何正确加载ffmpeg和opencv的本地库（so文件）是一个常见的挑战，尤其是在将项目打包成jar文件后运行时更为明显。以下详细探讨这个问题并提供解决方案。

Springboot项目中FFmpeg和OpenCV的so依赖加载问题

在使用Springboot进行项目开发时，如何正确加载FFmpeg和OpenCV的本地库（so文件）是一个常见的问题，特别是在打包成JAR文件后运行时尤为明显。下面详细探讨这个问题并提供解决方案。

问题背景

在开发过程中，我们使用了Java 21和Springboot 3，并通过Maven依赖引入了FFmpeg 7.1-1.5.11和OpenCV 4.10.0-1.5.11。配置文件pom.xml中详细列出了这些依赖：

    1.5.11
    4.10.0-1.5.11
    7.1-1.5.11
    linux-x86_64
    windows-x86_64
    ${javacpp.platform.linux-x86_64}


    
        org.bytedeco
        javacpp
        ${bytedeco.version}
    
    
        org.bytedeco
        javacv
        ${bytedeco.version}
    
    
        org.bytedeco
        opencv
        ${opencv-platform.version}
        ${javacpp.platform}
    
    
        org.bytedeco
        ffmpeg
        ${ffmpeg-platform.version}
        ${javacpp.platform}
    

在IDE开发环境中，这些依赖库可以正常加载并使用。然而，当将项目打包成JAR文件后，运行时却无法找到这些本地库，导致出现类似下面的错误：

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.UnsatisfiedLinkError: no jniavutil in java.library.path: /usr/java/packages/lib:/usr/lib64:/lib64:/lib:/usr/lib [in thread "http-nio-8100-exec-1"]

问题分析

当项目打包成JAR文件后，FFmpeg和OpenCV的本地库被嵌套在JAR包中的BOOT-INF/lib目录下，运行时这些库无法被JavaCPP的Loader类直接访问。开发环境之所以能够正常加载，是因为IDE将这些依赖添加到了classpath中。

解决方案

1. 在应用启动时编程方式配置JavaCPP

   可以通过编写一个配置类，在应用启动时设置JavaCPP的相关属性，并预加载所需的库：

   package com.demo.config;
   import org.bytedeco.javacpp.Loader;
   import org.springframework.context.annotation.Configuration;
   import javax.annotation.PostConstruct;
   @Configuration
   public class JavaCppConfig {
   @PostConstruct
   public void init() {
       System.setProperty("org.bytedeco.javacpp.extract", "true");
       System.setProperty("org.bytedeco.javacpp.extractDir", "/tmp/javacpp-native-libs");
   
       try {
           Loader.load(org.bytedeco.ffmpeg.global.avutil.class);
           Loader.load(org.bytedeco.ffmpeg.global.avcodec.class);
           Loader.load(org.bytedeco.ffmpeg.global.avformat.class);
           Loader.load(org.bytedeco.ffmpeg.global.swscale.class);
   
           Loader.load(org.bytedeco.opencv.global.opencv_core.class);
           Loader.load(org.bytedeco.opencv.global.opencv_imgproc.class);
   
           System.out.println("Native libraries loaded successfully");
       } catch (Exception e) {
           System.err.println("Failed to load native libraries: " + e.getMessage());
           e.printStackTrace();
       }
   }
   }
   
   

2. 自定义Docker镜像构建

   

   LogoMaker

   免费在线制作Logo，在几分钟内完成标志设计

   下载

   为了在Docker环境中运行，可以创建一个自定义的Dockerfile来预先提取和配置本地库路径：

   FROM openjdk:21-slim
   RUN apt-get update && apt-get install -y \
   libgomp1 \
   && rm -rf /var/lib/apt/lists/*
   RUN mkdir -p /opt/javacpp-native-libs
   ENV JAVACPP_EXTRACT_DIR=/opt/javacpp-native-libs
   WORKDIR /app
   COPY target/*.jar app.jar
   RUN mkdir -p /tmp/extract && \
   cd /tmp/extract && \
   java -Dorg.bytedeco.javacpp.extract=true \
   -Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs \
   -jar /app/app.jar --extract-native-libraries && \
   rm -rf /tmp/extract
   ENV JAVA_OPTS="-Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs -Dorg.bytedeco.javacpp.extract=false"
   ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]