NetBeans 14中调用OpenCV Dnn.readNetFromCaffe_0遇UnsatisfiedLinkError

问题场景 #

在NetBeans 14中编译包含OpenCV DNN模块的代码正常，但运行时抛出java.lang.UnsatisfiedLinkError，错误指向org.opencv.dnn.Dnn.readNetFromCaffe_0方法。已尝试添加OpenCV 4.7.0/4.6.0库，将opencv-470.jar及对应.dll文件放入工作目录，且模型文件已添加，但问题依旧。

错误堆栈 #

run:
Exception in thread "main" java.lang.UnsatisfiedLinkError: 'long org.opencv.dnn.Dnn.readNetFromCaffe_0(java.lang.String, java.lang.String)'
    at org.opencv.dnn.Dnn.readNetFromCaffe_0(Native Method)
    at org.opencv.dnn.Dnn.readNetFromCaffe(Dnn.java:130)
    at AgeGenderRecognition.AgeGenderRecognition.main(AgeGenderRecognition.java:27)
C:\Users\cam30\AppData\Local\NetBeans\Cache\14\executor-snippets\run.xml:111: The following error occurred while executing this line:
C:\Users\cam30\AppData\Local\NetBeans\Cache\14\executor-snippets\run.xml:68: Java returned: 1
BUILD FAILED (total time: 0 seconds)

相关代码片段 #

public static void main(String[] args){
    // Load networks
    Net ageNet = Dnn.readNetFromCaffe("age_net.caffemodel", "age_deploy.prototxt");
    Net genderNet = Dnn.readNetFromCaffe("gender_net.caffemodel", "gender_deploy.prototxt");
    Net faceNet = Dnn.readNetFromTensorflow("opencv_face_detector_uint8.pb", "opencv_face_detector.pbtxt");
}

解决方案 #

1. 显式加载OpenCV本地库 #

在调用任何OpenCV API之前，必须先加载本地库。修改main方法，在最开头添加加载代码：

public static void main(String[] args){
    // 优先加载OpenCV本地库
    System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
    // 再执行网络加载逻辑
    Net ageNet = Dnn.readNetFromCaffe("age_net.caffemodel", "age_deploy.prototxt");
    // 后续代码...
}

2. 正确配置本地库路径 #

NetBeans运行时可能无法自动识别工作目录中的.dll文件，需通过VM参数指定库路径：

• 右键项目 → 属性 → 运行 → VM选项
• 添加参数：-Djava.library.path=你的OpenCV本地库路径
  示例：-Djava.library.path=C:\opencv\build\java\x64
• 注意：路径要对应你安装的OpenCV版本的x64/x86目录，且必须与JDK位数一致（64位JDK用x64库，32位用x86）。

3. 验证库版本一致性 #

• 确保opencv-xx.jar（如opencv-470.jar）与本地库opencv_java470.dll的版本完全匹配，不能混用4.7.0和4.6.0的文件。
• 若使用OpenCV官网预编译包，本地库默认在opencv\build\java\x64目录下，确认文件未缺失。

4. 确认JDK与OpenCV位数匹配 #

• 打开命令提示符输入java -version，查看JDK是64位还是32位。
• 下载对应位数的OpenCV预编译包，64位JDK必须搭配64位OpenCV库，否则无法加载本地库。

5. 验证模型文件路径（可选） #

若解决链接错误后仍有问题，可打印当前工作目录确认模型路径是否正确：

System.out.println(System.getProperty("user.dir"));

确保age_net.caffemodel等文件位于该目录下，或改用绝对路径加载模型。

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