在spring boot項目中確保ffmpeg和opencv的so文件在打包后正確加載的詳細指南如下：
在使用spring boot 3開發項目時，已經集成了FFmpeg 7.1-1.5.11和OpenCV 4.10.0-1.5.11，并通過JavaCPP和JavaCV庫實現了視頻處理功能。雖然在開發環境中項目運行正常，但打包成jar文件后，FFmpeg和OpenCV的so依賴文件無法正確加載，導致應用無法啟動。
問題分析
開發環境下運行時，ide會將所有依賴庫添加到classpath中，使得FFmpeg和OpenCV的so文件能被正確加載。然而，一旦項目打包成jar文件，這些so文件會被嵌入到jar包的BOOT-INF/lib目錄中，JavaCPP的Loader類無法直接訪問這些文件，從而在運行時引發java.lang.UnsatisfiedLinkError錯誤。
解決方案
-
在應用啟動時配置JavaCPP
通過編程方式在應用啟動時配置JavaCPP，確保so文件能夠被正確提取和加載。以下是一個示例配置類：
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() { // 設置JavaCPP提取本地庫的目錄 System.setProperty("org.bytedeco.javacpp.extract", "true"); System.setProperty("org.bytedeco.javacpp.extractDir", "/tmp/javacpp-native-libs"); // 預加載需要的庫，這會觸發JavaCPP從jar中提取庫文件 try { // 預加載FFmpeg相關庫 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); // 預加載OpenCV庫 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(); } }}
這個配置類在應用啟動時設置了JavaCPP的提取路徑，并預加載了FFmpeg和OpenCV的相關庫，確保so文件能夠被正確提取和加載。
-
自定義docker鏡像構建
如果需要構建Docker鏡像，可以通過自定義Dockerfile來預先提取so文件，并配置好本地庫路徑。以下是一個示例Dockerfile：
FROM openjdk:21-slim</p><h1>安裝程序運行所需的庫</h1><p>RUN apt-get update && apt-get install -y libgomp1 && rm -rf /var/lib/apt/lists/*</p><h1>創建目錄用于提取本地庫</h1><p>RUN mkdir -p /opt/javacpp-native-libs ENV JAVACPP_EXTRACT_DIR=/opt/javacpp-native-libs</p><h1>設置工作目錄</h1><p>WORKDIR /app</p><h1>復制應用jar包</h1><p>COPY target/*.jar app.jar</p><h1>預先提取所有本地庫到指定目錄</h1><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><h1>設置系統屬性，指向提取的本地庫位置</h1><p>ENV JAVA_OPTS="-Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs -Dorg.bytedeco.javacpp.extract=false"</p><h1>啟動應用</h1><p>ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
通過這個Dockerfile，可以在鏡像構建過程中預先提取so文件，并配置好本地庫路徑，確保應用在Docker容器中能夠正常運行。
-
通過Java系統屬性配置JavaCPP
在啟動應用時，可以通過添加以下Java系統屬性來配置JavaCPP：
java -Djava.library.path=path/to/extracted/libs -Djavacpp.platform=linux-x86_64 -jar your-app.jar
這樣可以手動指定本地庫路徑和平臺，確保so文件能夠被正確加載。
通過上述方法，可以確保在Spring Boot項目中，FFmpeg和OpenCV的so文件在打包后能夠正確加載，既能解決開發環境的問題，也能確保在Docker容器中正常運行。
