OpenCV 4.9.0本地库未找到报错，求NetBeans下解决方案

错误日志 #

Exception in thread "AWT-EventQueue-0" java.lang.UnsatisfiedLinkError: 'long org.opencv.core.Mat.n_Mat()'
    at org.opencv.core.Mat.n_Mat(Native Method)
    at org.opencv.core.Mat.<init>(Mat.java:23)
    at temp.registerface.<init>(registerface.java:53)
    at temp.new_student.jButton2ActionPerformed(new_student.java:242)
    at temp.new_student$2.actionPerformed(new_student.java:121)
    at java.desktop/javax.swing.AbstractButton.fireActionPerformed(AbstractButton.java:1972)
    at java.desktop/javax.swing.AbstractButton$Handler.actionPerformed(AbstractButton.java:2314)
    at java.desktop/javax.swing.DefaultButtonModel.fireActionPerformed(DefaultButtonModel.java:407)
    at java.desktop/javax.swing.DefaultButtonModel.setPressed(DefaultButtonModel.java:262)
    at java.desktop/javax.swing.plaf.basic.BasicButtonListener.mouseReleased(BasicButtonListener.java:279)
    at java.desktop/java.awt.AWTEventMulticaster.mouseReleased(AWTEventMulticaster.java:297)
    at java.desktop/java.awt.Component.processMouseEvent(Component.java:6621)
    at java.desktop/javax.swing.JComponent.processMouseEvent(JComponent.java:3398)
    at java.desktop/java.awt.Component.processEvent(Component.java:6386)
    at java.desktop/java.awt.Container.processEvent(Container.java:2266)
    at java.desktop/java.awt.Component.dispatchEventImpl(Component.java:4996)
    at java.desktop/java.awt.Container.dispatchEventImpl(Container.java:2324)

问题描述 #

为使用OpenCV的face_module，我通过Visual Studio编译生成新jar包并添加到项目Install目录的java文件夹下，现在出现本地库找不到的错误，提示“native lib not found, nodefclass”。已尝试以下操作但问题未解决：

• 修改-Djava.library.path指向dll文件所在目录
• 在CMake中配置BUILD_SHARED_LIBS=OFF并重新生成jar包
• 将x64/vc17/bin添加到系统环境变量
  使用NetBeans开发，求排查操作中的错误。

核心问题分析 #

UnsatisfiedLinkError本质是JVM无法匹配JNI本地库，或库与jar包的JNI签名不兼容。结合你的操作，重点排查以下几点：

1. 修正BUILD_SHARED_LIBS配置错误 #

当设置BUILD_SHARED_LIBS=OFF时，OpenCV会编译生成静态库（.lib），但Java的JNI调用必须依赖动态链接库（.dll），静态库无法被JVM直接加载。需将BUILD_SHARED_LIBS改回ON，重新编译生成对应.dll文件。

2. 确保Jar包与本地库版本完全匹配 #

• 编译生成的jar包和.dll必须是同一批次的产物：jar包中的JNI方法签名需与.dll的导出函数完全一致，不同编译配置或批次的产物会出现不兼容。
• 检查CMake编译配置：确保BUILD_opencv_face选项被勾选，否则生成的库中不包含人脸模块的JNI实现。

3. 正确配置NetBeans项目的java.library.path #

NetBeans中全局VM参数或系统环境变量的修改可能不生效，需在项目级别配置：

1. 右键项目 → 属性 → 运行 → VM选项，添加：

   -Djava.library.path="你的dll所在目录绝对路径"
   

   路径需用双引号包裹，Windows系统使用反斜杠\或双反斜杠\\。
2. 验证配置有效性：在代码中添加打印语句，确认路径是否正确加载：

   System.out.println(System.getProperty("java.library.path"));
   

4. 检查本地库的依赖完整性 #

• OpenCV动态库依赖VC运行时库，需安装对应版本的VC Redistributable（vc17对应Visual Studio 2022版本）。
• 使用VS命令提示符执行dumpbin /dependents your_opencv_dll.dll，检查dll的依赖项是否全部存在，避免因缺失间接依赖导致加载失败。

5. 确认Jar包导入的正确性 #

• 确保NetBeans中添加的是包含face_module的自定义编译jar包，而非官方默认jar包。
• 检查项目库依赖：右键项目 → 属性 → 库，确认该jar包已添加到编译和运行路径中，且无冲突的其他OpenCV jar包。

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