OpenCV(OpenPnP打包版)加载失败：java.library.path找不到opencv_java460

核心问题 #

你同时调用了nu.pattern.OpenCV.loadLocally()和System.loadLibrary()，这两个操作存在冲突。OpenPnP封装的OpenCV库已通过loadLocally()自动完成本地库的检测、下载与加载流程，手动调用System.loadLibrary()会重复触发加载逻辑，导致库路径匹配失败。

解决方案步骤 #

1. 移除重复加载语句
   直接删除System.loadLibrary(org.opencv.core.Core.NATIVE_LIBRARY_NAME);，仅保留以下代码即可：

   nu.pattern.OpenCV.loadLocally();
   

2. 校验Maven依赖配置
   确保pom.xml中OpenPnP版OpenCV的依赖配置正确，4.6.0版本的依赖如下：

   <dependency>
       <groupId>org.openpnp</groupId>
       <artifactId>opencv</artifactId>
       <version>4.6.0-0</version>
   </dependency>
   

   注意版本号后缀的-0是OpenPnP的打包标识，不可遗漏。

3. 清理项目缓存并重构

   • 在IntelliJ中执行File → Invalidate Caches...，重启IDE以清除缓存的依赖文件。
   • 执行mvn clean install（Maven项目），重新下载依赖并构建项目。

4. 检查JVM与库架构匹配

   • 确认JVM架构与系统一致：64位系统必须使用64位JVM，32位JVM无法加载64位OpenCV本地库。
   • 在IntelliJ的运行配置中，检查VM options是否存在强制32位的参数（如-d32），若有则移除。

5. 手动指定库路径（备选方案）
   若自动加载仍失败，可手动下载对应系统的OpenPnP版OpenCV本地库，然后在JVM启动参数中指定路径：

   • 下载对应系统的库文件（如macOS的libopencv_java460.dylib）
   • 在运行配置的VM options中添加：

     -Djava.library.path=/path/to/your/library/folder
     

   注意此方案与loadLocally()不可同时使用，二选一即可。

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