在springboot項目中，如何正確加載ffmpeg和opencv的本地庫（so文件）是一個常見的挑戰(zhàn)，尤其是在將項目打包成jar文件后運行時更為明顯。以下詳細探討這個問題并提供解決方案。
Springboot項目中FFmpeg和OpenCV的so依賴加載問題
在使用Springboot進行項目開發(fā)時，如何正確加載FFmpeg和OpenCV的本地庫（so文件）是一個常見的問題，特別是在打包成JAR文件后運行時尤為明顯。下面詳細探討這個問題并提供解決方案。
問題背景
在開發(fā)過程中，我們使用了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開發(fā)環(huán)境中，這些依賴庫可以正常加載并使用。然而，當將項目打包成JAR文件后，運行時卻無法找到這些本地庫，導致出現(xiàn)類似下面的錯誤：
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文件后，F(xiàn)Fmpeg和OpenCV的本地庫被嵌套在JAR包中的BOOT-INF/lib目錄下，運行時這些庫無法被JavaCPP的Loader類直接訪問。開發(fā)環(huán)境之所以能夠正常加載，是因為IDE將這些依賴添加到了classpath中。
解決方案
-
在應用啟動時編程方式配置JavaCPP
可以通過編寫一個配置類，在應用啟動時設(shè)置JavaCPP的相關(guān)屬性，并預加載所需的庫：
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鏡像構(gòu)建
為了在Docker環(huán)境中運行，可以創(chuàng)建一個自定義的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的本地庫，無論是在開發(fā)環(huán)境還是打包成JAR文件運行，甚至是在Docker容器中。需要注意的是，在不同平臺上可能需要調(diào)整javacpp.platform屬性，并確保JavaCPP能夠?qū)懭肱R時目錄來提取本地庫。
