我最近花了好几个小时啃一个棘手的问题：只有在Android 6.0（API 23）实体设备上加载C++ NDK库时会崩溃，模拟器上完全复现不了，报错信息如下：

java.lang.UnsatisfiedLinkError: 
  at java.lang.Runtime.loadLibrary (Runtime.java:367) 
  at java.lang.System.loadLibrary (System.java:1076) 
  at [removed].Engine.<clinit> (Engine.java:13)

我已经试过手动修改CMake配置强制启用PIE（本来以为默认是开启的），但问题依然没解决。结合这个场景，我整理了几个额外的排查方向和解决方案：

1. 确认PIE是否真的生效 #

虽然Android 6.0要求动态库必须是PIE格式，但有时候CMake的默认配置可能因为项目结构或NDK版本差异没正确开启。可以通过以下步骤验证：

• 用readelf -h命令检查生成的.so文件，查看Type字段是否为DYN (Shared object file)且Flags包含PIE
• 在CMakeLists.txt中显式添加PIE编译选项：

  set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -fPIE")
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIE")
  set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -fPIE -pie")
  

2. 检查NDK版本兼容性 #

Android 6.0对NDK版本有一定要求，如果你用的是较新的NDK版本（比如r21+），可能需要调整APP_PLATFORM到android-23或更低，确保编译出来的库兼容旧系统。可以在build.gradle中指定：

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a' // 根据目标设备架构调整
            platformVersion 23
        }
    }
}

3. 排查库依赖缺失 #

实体设备可能缺少模拟器上默认存在的系统依赖库。可以用ldd命令（或Android Studio的Native Library Debugger）检查你的.so文件依赖的系统库，确认Android 6.0是否支持这些库。比如某些新的libc特性在Android 6.0中不存在，这时候可以切换到静态链接libc：

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -static-libstdc++")

4. 检查加载顺序与库路径 #

确保你加载的库路径在Android 6.0上是可访问的，避免因权限问题或路径错误导致加载失败。另外，如果你有多个依赖库，要保证依赖库先于主库加载：

static {
    System.loadLibrary("dependency-lib");
    System.loadLibrary("main-lib");
}

5. 启用更详细的日志 #

在Android 6.0设备上开启Native调试日志，通过adb logcat查看更具体的加载失败原因，比如哪个符号找不到或者库加载时的权限问题：

adb logcat -v time | grep -i "linker\|UnsatisfiedLinkError"

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