在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中详细列出了这些依赖：
<properties> <bytedeco.version>1.5.11</bytedeco.version> <opencv-platform.version>4.10.0-1.5.11</opencv-platform.version> <ffmpeg-platform.version>7.1-1.5.11</ffmpeg-platform.version> <javacpp.platform.linux-x86_64>linux-x86_64</javacpp.platform.linux-x86_64> <javacpp.platform.windows-x86_64>windows-x86_64</javacpp.platform.windows-x86_64> <javacpp.platform>${javacpp.platform.linux-x86_64}</javacpp.platform> </properties> <dependencies> <dependency> <groupId>org.bytedeco</groupId> <artifactId>javacpp</artifactId> <version>${bytedeco.version}</version> </dependency> <dependency> <groupId>org.bytedeco</groupId> <artifactId>javacv</artifactId> <version>${bytedeco.version}</version> </dependency> <dependency> <groupId>org.bytedeco</groupId> <artifactId>opencv</artifactId> <version>${opencv-platform.version}</version> <classifier>${javacpp.platform}</classifier> </dependency> <dependency> <groupId>org.bytedeco</groupId> <artifactId>ffmpeg</artifactId> <version>${ffmpeg-platform.version}</version> <classifier>${javacpp.platform}</classifier> </dependency> </dependencies>
在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中。
解决方案
-
在应用启动时编程方式配置JavaCPP
可以通过编写一个配置类，在应用启动时设置JavaCPP的相关属性，并预加载所需的库：
package com.demo.config; <p>import org.bytedeco.javacpp.Loader; import org.springframework.context.annotation.Configuration; import javax.annotation.PostConstruct;</p><p>@Configuration public class JavaCppConfig {</p><pre class="brush:php;toolbar:false">@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(); } }}
-
自定义docker镜像构建
为了在Docker环境中运行，可以创建一个自定义的Dockerfile来预先提取和配置本地库路径：
FROM openjdk:21-slim</p><p>RUN apt-get update && apt-get install -y libgomp1 && rm -rf /var/lib/apt/lists/*</p><p>RUN mkdir -p /opt/javacpp-native-libs ENV JAVACPP_EXTRACT_DIR=/opt/javacpp-native-libs</p><p>WORKDIR /app</p><p>COPY target/*.jar app.jar</p><p>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</p><p>ENV JAVA_OPTS="-Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs -Dorg.bytedeco.javacpp.extract=false"</p><p>ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
通过上述方法，可以确保在Springboot项目中正确加载FFmpeg和OpenCV的本地库，无论是在开发环境还是打包成JAR文件运行，甚至是在Docker容器中。需要注意的是，在不同平台上可能需要调整javacpp.platform属性，并确保JavaCPP能够写入临时目录来提取本地库。
