.jpg)
在spring boot項(xiàng)目中正確加載ffmpeg和opencv的so依賴是一個常見的問題。以下是基于Java 21和spring boot 3版本的詳細(xì)指南，介紹如何在打包后的項(xiàng)目中正確加載這些本地庫。
我們首先來看一下項(xiàng)目的依賴配置和打包后的jar包結(jié)構(gòu)：
項(xiàng)目依賴配置（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>
打包后jar包的結(jié)構(gòu)（簡化版）：
在Spring Boot的jar包中，BOOT-INF/lib目錄下包含了ffmpeg-7.1-1.5.11-linux-x86_64.jar和opencv-4.10.0-1.5.11-linux-x86_64.jar，這些jar包中包含了運(yùn)行所需的so依賴。
然而，實(shí)際運(yùn)行時系統(tǒng)并未從這些jar包中加載so文件，導(dǎo)致出現(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"]
這個問題主要是因?yàn)镴avaCPP的Loader類無法找到并解壓這些本地庫文件。在開發(fā)環(huán)境中，ide會自動將所有依賴添加到classpath中，因此能夠正常加載。但是打包成jar后，這些嵌套在jar包中的本地庫無法被直接訪問。
為了解決這個問題，可以采取以下兩種方法：
1. 在應(yīng)用啟動時編程方式配置JavaCPP
可以通過創(chuàng)建一個Spring Boot配置類，在應(yīng)用啟動時執(zhí)行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() { // 設(shè)置JavaCPP提取本地庫的目錄 System.setProperty("org.bytedeco.javacpp.extract", "true"); System.setProperty("org.bytedeco.javacpp.extractDir", "/tmp/javacpp-native-libs"); // 預(yù)加載需要的庫，這會觸發(fā)JavaCPP從jar中提取庫文件 try { // 預(yù)加載FFmpeg相關(guān)庫 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); // 預(yù)加載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(); } }
}
2. 自定義docker鏡像構(gòu)建
為了在Docker環(huán)境中正確加載這些庫，可以創(chuàng)建一個自定義的Dockerfile：
FROM openjdk:21-slim</p><h1>安裝程序運(yùn)行所需的庫</h1><p>RUN apt-get update && apt-get install -y libgomp1 && rm -rf /var/lib/apt/lists/*</p><h1>創(chuàng)建目錄用于提取本地庫</h1><p>RUN mkdir -p /opt/javacpp-native-libs ENV JAVACPP_EXTRACT_DIR=/opt/javacpp-native-libs</p><h1>設(shè)置工作目錄</h1><p>WORKDIR /app</p><h1>復(fù)制應(yīng)用jar包</h1><p>COPY target/*.jar app.jar</p><h1>預(yù)先提取所有本地庫到指定目錄</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>設(shè)置系統(tǒng)屬性，指向提取的本地庫位置</h1><p>ENV JAVA_OPTS="-Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs -Dorg.bytedeco.javacpp.extract=false"</p><h1>啟動應(yīng)用</h1><p>ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
通過以上兩種方法，我們可以在應(yīng)用啟動時確保正確加載FFmpeg和OpenCV的so文件，并且在Docker環(huán)境中也能正常運(yùn)行，而無需修改基礎(chǔ)鏡像。
此外，還可以嘗試通過在啟動應(yīng)用時添加系統(tǒng)屬性來配置JavaCPP：
java -Djava.library.path=path/to/extracted/libs -Djavacpp.platform=linux-x86_64 -jar your-app.jar
需要注意的是，JavaCPP需要能夠?qū)懭肱R時目錄來提取本地庫，同時在Docker環(huán)境中，可能需要添加-Dorg.bytedeco.javacpp.maxphysicalbytes=0來防止內(nèi)存限制問題。如果使用多個平臺（如Windows和Linux），請注意配置正確的platform屬性。
.png)
