APK内已包含libc++_shared但运行加载库时提示找不到该文件

AI 小北

2026-8-28

问题根因

这个报错和so是否打包进APK无直接关联，核心触发原因是Android原生库命名空间隔离机制+so加载顺序错误：
Android 7.0（API 24）及以上版本为类加载器增加了原生库命名空间隔离限制，System.loadLibrary() 不会自动递归加载目标库的依赖项。如果直接加载libopencv_java4.so，此时它依赖的libc++_shared.so还未被加载进当前类加载器的命名空间，就会抛出你看到的dlopen failed: library "libc++_shared.so" not found错误，哪怕两个so文件确实已经存放在APK的lib/{ABI}路径下。
早期直接引入原AAR可正常运行，是因为原AAR自带的构建配置、OpenCV初始化逻辑会隐式保证libc++_shared.so优先加载，你手动解压AAR替换so文件后，这套隐式加载逻辑被破坏。

修复方案

按优先级从高到低验证，绝大多数场景下第一个方案即可解决问题：

调整so加载顺序，显式优先加载依赖库
将原有加载OpenCV的代码，调整为先加载c++共享库，再加载OpenCV库：
```
// 必须放在opencv_java4加载前执行
System.loadLibrary("c++_shared");
System.loadLibrary("opencv_java4");
```
如果你之前使用OpenCV官方提供的OpenCVLoader做异步初始化，建议直接废弃这套逻辑，在应用启动的静态代码块里按上述顺序手动加载即可，避免OpenCV自带的加载逻辑跳过依赖库加载步骤。
修正Gradle打包配置，避免so打包异常
打开app模块的build.gradle文件，在android{}配置块中增加如下内容，明确指定jni库存放路径、解决同名so冲突：
```
android {
    sourceSets {
        main {
            // 替换为你实际存放so文件的目录，确保目录层级为 {jniLibs目录}/{ABI名}/xxx.so
            jniLibs.srcDirs = ['src/main/jniLibs']
        }
    }
    packagingOptions {
        pickFirst 'lib/*/libc++_shared.so'
        pickFirst 'lib/*/libopencv_java4.so'
    }
}
```
如果你在AndroidManifest.xml的<application>标签中配置了android:extractNativeLibs="false"，必须确认上述jniLibs路径配置正确，否则so会被压缩打包，导致系统无法直接识别加载。
校验so文件本身的依赖匹配性
如果前两个方案都无效，使用本地Android NDK自带的readelf工具检查你提取的libopencv_java4.so依赖项：进入对应ABI的so目录，执行如下命令查看依赖库列表：
```
# 以arm64-v8a架构为例
aarch64-linux-android-readelf -d libopencv_java4.so | grep NEEDED
```
如果输出中libc++_shared.so带有版本后缀、路径前缀，说明你提取的so和libc++_shared.so版本不匹配，替换为对应版本的libc++_shared.so即可。

避坑提示

不要依赖Gradle自动引入c++_shared：如果你的项目本身没有编写C代码、未启用CMake/NDK构建流程，Gradle不会自动将C共享运行时打入APK，这也是你之前不手动引入so时APK内缺失libc++_shared.so的原因。
每次修改构建配置后，除了清理Gradle缓存，还要将测试设备上已安装的旧版本APK完全卸载后再重装，避免系统缓存旧的so文件导致误判。

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