android N : UnsatisfiedLinkError

最新推荐文章于 2025-06-25 09:00:07 发布

原创最新推荐文章于 2025-06-25 09:00:07 发布 · 4.9k 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#android-N #Unsatisfie

Android General 专栏收录该内容

50 篇文章

订阅专栏

在Android N系统中，使用.so文件作为第三方库时可能会遇到java.lang.UnsatisfiedLinkError异常。此问题源于Google对.so文件加载路径的限制。本文介绍了问题的根本原因，并提供了两种解决方案：一是遵循Google官方指南调整；二是手动修改设备配置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在android N上使用 .so作为apk的第三方库的时候，会发生java.lang.UnsatisfiedLinkError:

09-27 12:17:01.280 D/ListenSoundModel( 3635): Load libxxxjni
09-27 12:17:01.292 D/AndroidRuntime( 3635): Shutting down VM
——— beginning of crash
09-27 12:17:01.293 E/AndroidRuntime( 3635): FATAL EXCEPTION: main
09-27 12:17:01.293 E/AndroidRuntime( 3635): Process: com.qualcomm.xxx, PID: 3635
09-27 12:17:01.293 E/AndroidRuntime( 3635): java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[DexPathList[[zip file “/data/app/xxxApp.apk”],nativeLibraryDirectories=[/data/app-lib/xxxApp, /system/lib64, /vendor/lib64]]] couldn’t find “libxxxjni.so”
09-27 12:17:01.293 E/AndroidRuntime( 3635): at java.lang.Runtime.loadLibrary0(Runtime.java:972)
09-27 12:17:01.293 E/AndroidRuntime( 3635): at java.lang.System.loadLibrary(System.java:1530)
…
09-27 12:17:01.293 E/AndroidRuntime( 3635): at android.os.Handler.dispatchMessage(Handler.java:102)
09-27 12:17:01.293 E/AndroidRuntime( 3635): at android.os.Looper.loop(Looper.java:154)

这在google的变更说明有介绍https://developer.android.com/preview/behavior-changes.html#ndk，

具体是什么原因呢，怎么解决这种问题呢，google给出了一个官方的解决办法（如上链接），这里也给出另外一种方法。

首先，主要原因是google在N上对.so库的加载进行了限制，限制了so库指从部分指定的路径进行加载，不在这个路径的so提示
java.lang.UnsatisfiedLinkError: dlopen failed: library “xxx.so” not found 或
java.lang.UnsatisfiedLinkError: dlopen failed: library “/vendor/lib64/xxx.so” needed or dlopened by “/system/lib64/libnativeloader.so” is not accessible for the namespace “classloader-namespace” 或其他异常错误提示。

N上对so库加载的搜索路径方式为ld_library_path, runtime path, permit path，不在这个搜索路径下则加载失败。

从代码层面看，主要是类加载器ClassLoader的相关处理，
code1: (loadedApk.java getClassLoader()) check sdk version
// DO NOT SHIP: this is a workaround for apps loading native libraries
// provided by 3rd party apps using absolute path instead of corresponding
// classloader; see http://b/26954419 for example.
if (mApplicationInfo.targetSdkVersion <= 23) {
libraryPermittedPath += File.pathSeparator + “/data/app”;
}

Code2: (loadedApk.java getClassLoader()) N add a new PermittedPath
String libraryPermittedPath = mDataDir;

Code3: (native_loader.cpp) use the new namespace rule with search path: ld_library_path, runtime path, permit path.

在明白原因之后，
解决办法则是将自己的so加入到允许路径的白名单里面，具体操作为，如果不改代码实现，则导出设备的/vendor/etc/public.libraries.txt 或/etc/public.libraries.txt文件，将so名字添加进去，在push到设备，重启即可。