OpenCV 3.4.1 Java环境下FaceRecognizer创建失败求助

你遇到的问题核心原因很明确：OpenCV的人脸识别模块（org.opencv.face包）并不在核心库中，而是属于OpenCV的contrib扩展模块，默认安装或引入的OpenCV 3.4.x不会包含这个模块，这就导致了你找不到包，以及创建LBPHFaceRecognizer时抛出UnsatisfiedLinkError——因为对应的本地库文件根本没被加载进来。

下面是具体的解决步骤：

1. 获取包含contrib模块的OpenCV包 #

根据你引入OpenCV的方式，分两种情况处理：

如果你用Maven/Gradle管理依赖 #

官方的OpenCV Maven包不包含contrib模块，你需要使用第三方打包的包含contrib的版本。以Maven为例，3.4.1版本的依赖坐标可以用：

<dependency>
    <groupId>org.openpnp</groupId>
    <artifactId>opencv</artifactId>
    <version>3.4.1-2</version>
</dependency>

这个包已经预编译好了contrib模块，包含org.opencv.face在内的扩展功能。Gradle用户对应的依赖是：

implementation 'org.openpnp:opencv:3.4.1-2'

如果你手动下载或编译OpenCV #

• 手动下载：可以去找已经包含contrib模块的预编译包，或者直接从OpenCV官网下载源码，同时下载对应版本的OpenCV Contrib源码。
• 编译源码：用CMake配置编译时，需要指定contrib模块的路径，并且勾选OPENCV_ENABLE_NONFREE（如果用到相关功能），确保编译出来的库包含face模块。

2. 确保本地库正确加载 #

不管用哪种方式，都要确保OpenCV的本地库文件（Windows是.dll，Linux是.so，Mac是.dylib）被正确加载。在你的Java代码开头一定要加上：

import org.opencv.core.Core;

// 加载OpenCV本地库
static {
    System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
    // 如果你用的是openpnp的包，也可以用：OpenCV.loadShared();
}

另外要注意：本地库的架构（x86/x64）必须和你的JVM架构一致，比如64位JVM要加载64位的OpenCV库，否则也会出现加载失败的错误。

3. 验证功能是否正常 #

当你正确引入contrib模块并加载本地库后，org.opencv.face包就会出现在你的依赖中，这时候再执行：

LBPHFaceRecognizer faceRecognizer = LBPHFaceRecognizer.create();

就不会再抛出UnsatisfiedLinkError了。

额外注意事项 #

• 版本严格对应：contrib模块的版本必须和OpenCV核心库的版本完全一致（比如都是3.4.1），版本不匹配会导致各种链接或类找不到的错误。
• 检查库路径：如果手动指定库路径，可以通过System.setProperty("java.library.path", "你的OpenCV库所在路径")来设置，但要注意这个设置要在加载库之前执行。

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