在spring boot项目中正确加载ffmpeg和opencv的so依赖是一个常见的问题。以下是基于java 21和spring boot 3版本的详细指南，介绍如何在打包后的项目中正确加载这些本地库。
我们首先来看一下项目的依赖配置和打包后的jar包结构：
项目依赖配置（pom.xml）：
1.5.11 4.10.0-1.5.11 7.1-1.5.11 linux-x86_64 windows-x86_64 ${javacpp.platform.linux-x86_64} org.bytedeco javacpp ${bytedeco.version} org.bytedeco javacv ${bytedeco.version} org.bytedeco opencv ${opencv-platform.version} ${javacpp.platform} org.bytedeco ffmpeg ${ffmpeg-platform.version} ${javacpp.platform}
打包后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文件，导致出现以下错误：
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"]
这个问题主要是因为JavaCPP的Loader类无法找到并解压这些本地库文件。在开发环境中，IDE会自动将所有依赖添加到classpath中，因此能够正常加载。但是打包成jar后，这些嵌套在jar包中的本地库无法被直接访问。
为了解决这个问题，可以采取以下两种方法：
1. 在应用启动时编程方式配置JavaCPP
可以通过创建一个Spring Boot配置类，在应用启动时执行JavaCPP配置：
package com.demo.config;import org.bytedeco.javacpp.Loader; import org.springframework.context.annotation.Configuration; import javax.annotation.PostConstruct;
@Configuration public class JavaCppConfig {
@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(); } }}
2. 自定义Docker镜像构建
为了在Docker环境中正确加载这些库，可以创建一个自定义的Dockerfile：
FROM openjdk:21-slim安装程序运行所需的库
RUN apt-get update && apt-get install -y \ libgomp1 \ && rm -rf /var/lib/apt/lists/*
创建目录用于提取本地库
RUN mkdir -p /opt/javacpp-native-libs ENV JAVACPP_EXTRACT_DIR=/opt/javacpp-native-libs
设置工作目录
WORKDIR /app
复制应用jar包
COPY target/*.jar app.jar
预先提取所有本地库到指定目录
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
设置系统属性，指向提取的本地库位置
ENV JAVA_OPTS="-Dorg.bytedeco.javacpp.extractDir=/opt/javacpp-native-libs -Dorg.bytedeco.javacpp.extract=false"
启动应用
ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]
通过以上两种方法，我们可以在应用启动时确保正确加载FFmpeg和OpenCV的so文件，并且在Docker环境中也能正常运行，而无需修改基础镜像。
此外，还可以尝试通过在启动应用时添加系统属性来配置JavaCPP：
java -Djava.library.path=path/to/extracted/libs -Djavacpp.platform=linux-x86_64 -jar your-app.jar需要注意的是，JavaCPP需要能够写入临时目录来提取本地库，同时在Docker环境中，可能需要添加-Dorg.bytedeco.javacpp.maxphysicalbytes=0来防止内存限制问题。如果使用多个平台（如Windows和Linux），请注意配置正确的platform属性。
