SpringBoot+Gradle环境下OpenCV库UnsatisfiedLinkError问题求助

方法一：使用OpenPnP OpenCV自带的自动加载机制 #

org.openpnp提供的OpenCV包已内置各平台本地库，无需手动指定java.library.path，直接用其工具类加载即可：

1. 修改AiApplication代码，替换原有的System.loadLibrary调用：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.opencv.core.Mat;
import nu.pattern.OpenCV;

@SpringBootApplication
public class AiApplication {

   public static void main(String[] args) {
       // 优先加载OpenCV本地库
       OpenCV.loadShared();
       SpringApplication.run(AiApplication.class, args);
       System.out.print("Hello world");
       Mat mat = Mat.eye(3, 3, 0);
       System.out.println("OpenCV Mat:\n" + mat.dump());
   }
}

2. 重新构建并运行项目：

./gradlew build
java -jar ./build/libs/ai-0.0.1-SNAPSHOT.jar

方法二：手动提取本地库并指定路径 #

若必须使用System.loadLibrary，可手动从下载的jar中提取Linux平台本地库文件：

1. 解压Gradle缓存中的opencv jar，提取本地库：

unzip /home/pescador/.gradle/caches/modules-2/files-2.1/org.openpnp/opencv/4.5.1-1/31b0b04ae7565a746a15c930c3a246c2655da00c/opencv-4.5.1-1.jar "linux/x86_64/libopencv_java451.so" -d /tmp/opencv-lib

2. 将提取的so文件移动到系统默认库目录：

sudo cp /tmp/opencv-lib/linux/x86_64/libopencv_java451.so /usr/local/lib/
# 更新系统库缓存
sudo ldconfig

3. 直接运行项目（系统会自动搜索/usr/local/lib）：

java -jar ./build/libs/ai-0.0.1-SNAPSHOT.jar

若放在自定义目录（如/opt/opencv-lib），则运行：

java -Djava.library.path=/opt/opencv-lib -jar ./build/libs/ai-0.0.1-SNAPSHOT.jar

方法三：通过Gradle Application插件配置运行参数 #

使用Gradle的application插件，可在构建脚本中固定JVM参数，避免手动输入：

1. 在build.gradle中添加插件并配置：

plugins {
    id 'org.springframework.boot' version '2.7.0' // 替换为你的Spring Boot版本
    id 'io.spring.dependency-management' version '1.0.11.RELEASE'
    id 'java'
    id 'application'
}

mainClassName = 'com.example.AiApplication' // 替换为你的主类全限定名

application {
    applicationDefaultJvmArgs = [
        '-Djava.library.path=/usr/local/lib' // 填写存放opencv本地库的路径
    ]
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
    implementation 'org.openpnp:opencv:4.5.1-1'
}

2. 用Gradle命令启动项目：

./gradlew run

内容的提问来源于stack exchange，提问作者Puser