Android集成OpenCV自定义C++库崩溃：找不到libopencv_java3.so

这种低版本Android上的动态库加载坑我之前踩过，结合你用自定义C++库依赖OpenCV的场景，咱们从几个核心方向排查解决：

1. 调整动态库加载顺序 #

你的自定义库libmyLib.so依赖libopencv_java3.so，但Android 5.1（API 22）的动态加载机制不会自动处理依赖顺序。如果先加载自定义库，系统找不到依赖的OpenCV库就会直接崩溃。

解决办法：在MainActivity中先加载OpenCV的库，再加载自定义库：

static {
    // 先加载OpenCV依赖库
    System.loadLibrary("opencv_java3");
    // 再加载自己的自定义库
    System.loadLibrary("myLib");
}

2. 检查ABI适配是否正确 #

OnePlus X是32位ARM设备（armeabi-v7a架构），如果你的APK里没有包含对应ABI的OpenCV库，必然会出现找不到的情况。

• 确认app的build.gradle中指定了正确的ABI过滤：

android {
    defaultConfig {
        ndk {
            // 保留目标设备的ABI，别只留64位架构
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
}

• 如果你是手动导入OpenCV的so库，要把libopencv_java3.so放到src/main/jniLibs/armeabi-v7a/目录下。打包后可以用Android Studio的APK Analyzer查看APK的lib/armeabi-v7a/目录，确认两个库都存在。

3. 确认OpenCV依赖的版本适配 #

有些高版本的OpenCV已经不再支持Android 5.x，建议选择3.x系列的稳定版本。如果是通过gradle依赖OpenCV，确保依赖的是适配低版本的包：

dependencies {
    implementation 'org.opencv:opencv-android:3.4.16'
}

4. 尝试静态链接OpenCV（备选方案） #

如果动态加载的问题始终无法解决，可以考虑把OpenCV的模块静态链接到你的自定义库中，这样就不需要单独加载libopencv_java3.so了。

修改你的CMakeLists.txt，链接OpenCV静态库：

# 找到OpenCV包
find_package(OpenCV REQUIRED)
# 将OpenCV静态库链接到自定义库
target_link_libraries(myLib PRIVATE ${OpenCV_LIBS})

注意：静态链接会增大APK体积，需要根据实际需求权衡。

调试小技巧 #

用adb logcat查看更详细的崩溃日志，搜索dlopen相关的输出，确认是不是真的缺少libopencv_java3.so，还是有其他依赖库缺失的情况。

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