在spring boot项目中正确加载ffmpeg和opencv的so依赖是一个常见的问题。以下是基于java 21和spring boot 3版本的详细指南,介绍如何在打包后的项目中正确加载这些本地库。
我们首先来看一下项目的依赖配置和打包后的jar包结构:
项目依赖配置(pom.xml):
<code><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></code>打包后jar包的结构(简化版):
在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包中包含了运行所需的so依赖。
然而,实际运行时系统并未从这些jar包中加载so文件,导致出现以下错误:
<code>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"]</code>
这个问题主要是因为JavaCPP的Loader类无法找到并解压这些本地库文件。在开发环境中,IDE会自动将所有依赖添加到classpath中,因此能够正常加载。但是打包成jar后,这些嵌套在jar包中的本地库无法被直接访问。
为了解决这个问题,可以采取以下两种方法:
可以通过创建一个Spring Boot配置类,在应用启动时执行JavaCPP配置:
<code>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;"><code>@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();
}
}</code>}
为了在Docker环境中正确加载这些库,可以创建一个自定义的Dockerfile:
<code>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"]</code>
通过以上两种方法,我们可以在应用启动时确保正确加载FFmpeg和OpenCV的so文件,并且在Docker环境中也能正常运行,而无需修改基础镜像。
此外,还可以尝试通过在启动应用时添加系统属性来配置JavaCPP:
<code>java -Djava.library.path=path/to/extracted/libs -Djavacpp.platform=linux-x86_64 -jar your-app.jar</code>
需要注意的是,JavaCPP需要能够写入临时目录来提取本地库,同时在Docker环境中,可能需要添加-Dorg.bytedeco.javacpp.maxphysicalbytes=0来防止内存限制问题。如果使用多个平台(如Windows和Linux),请注意配置正确的platform属性。

以上就是在Spring Boot项目中如何正确加载FFmpeg和OpenCV的so依赖?的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号