Android Studio更新第三方.so库触发UnsatisfiedLinkError问题求助

你遇到的问题根源在于第三方共享库的SONAME属性变化——新的libthird_party_library.so内部设置了SONAME为libthird_party_library.so.2，导致动态链接器在加载时会寻找带.so.2后缀的文件，而非原名称的文件。下面是几个无需保留旧库的彻底解决方案：

1. 先确认第三方库的SONAME（可选但推荐） #

用readelf工具检查新库的SONAME，验证我们的推测：

readelf -d path/to/your/new/libthird_party_library.so | grep SONAME

如果输出类似0x0000000e (SONAME) Library soname: [libthird_party_library.so.2]，就坐实了问题原因。

2. 方案一：匹配SONAME调整文件命名与CMake配置 #

这是最规范的处理方式：

• 将新的第三方库文件重命名为libthird_party_library.so.2，放到对应ABI的jniLibs目录下
• 在该目录下创建符号链接：Linux/macOS用ln -s libthird_party_library.so.2 libthird_party_library.so，Windows用mklink libthird_party_library.so libthird_party_library.so.2
• 修改CMake配置，确保导入路径与SONAME匹配：

  add_library( libthird_party_library SHARED IMPORTED )
  set_target_properties( libthird_party_library PROPERTIES 
      IMPORTED_LOCATION ${pathToProject}/src/main/jniLibs/${ANDROID_ABI}/libthird_party_library.so
      IMPORTED_SONAME libthird_party_library.so.2
  )
  target_link_libraries( my-module-lib libthird_party_library )
  

  打包后动态链接器会通过符号链接找到对应的.so.2文件。

3. 方案二：直接在CMake中指定SONAME对应的文件 #

如果不想创建符号链接，可以直接修改CMake配置指向带后缀的文件，并显式声明SONAME：

add_library( libthird_party_library SHARED IMPORTED )
set_target_properties( libthird_party_library PROPERTIES 
    IMPORTED_LOCATION ${pathToProject}/src/main/jniLibs/${ANDROID_ABI}/libthird_party_library.so.2
    IMPORTED_SONAME libthird_party_library.so.2
)
target_link_libraries( my-module-lib libthird_party_library )

此时jniLibs目录下只需存放libthird_party_library.so.2，动态链接器会根据SONAME自动识别它。

4. 方案三：彻底清理所有旧库残留 #

如果之前的清理不彻底，可能存在旧库缓存：

• 删除项目根目录和模块目录下的build、.externalNativeBuild文件夹
• 删除Gradle缓存：找到~/.gradle/caches目录，删除与当前项目相关的缓存文件夹（或直接清空整个caches目录，不影响其他项目）
• 卸载设备上的旧APK，确保无残留
• 重新执行Clean Project -> Rebuild Project

5. 方案四：通过打包配置排除旧库 #

若担心打包时混入旧库，可在模块的build.gradle中添加过滤规则：

android {
    packagingOptions {
        // 排除旧的不带后缀的库文件
        exclude '**/libthird_party_library.so'
        // 确保只保留带.so.2后缀的新库
        pickFirst '**/libthird_party_library.so.2'
    }
}

以上方案中，方案一和方案二从根源解决SONAME匹配问题，方案三和方案四辅助清理残留、避免打包错误，结合使用效果最佳。

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