加载.so库时出现“has bad ELF magic”错误的解决方法咨询

问题回顾 #

将.a静态库转换为.so动态库后，Android运行时抛出以下错误：

Process: com.xxx.xxx.beta, PID: 25906
java.lang.UnsatisfiedLinkError: dlopen failed: "/data/app/com.xxx.xxx.beta-xxxxxxxxxxxxxxxxxxxxxxxx==/lib/x86/mylib.so" has bad ELF magic

已配置的Gradle参数：

sourceSets.main {
    jniLibs.srcDir 'src/main/jniLibs'
    jni.srcDirs = []
}

ndk {
    abiFilters 'x86', 'armeabi-v7a', 'x86_64', 'arm64-v8a'
}

具体解决方案 #

1. 验证.so文件的ELF格式有效性 #

"bad ELF magic"直接说明文件不是合法的ELF格式，大概率是转换过程出错：

• 用readelf -h your_lib.so命令查看文件头部，确认开头是否包含ELF标识。如果输出提示不是ELF文件，说明转换失败，需重新生成。
• 确保转换使用的NDK工具链版本，与项目编译依赖的NDK版本完全一致，不同版本工具链生成的文件可能存在兼容性问题。

2. 修正静态库转动态库的编译命令 #

将.a转为.so必须使用NDK工具链执行正确的链接命令，示例（以x86架构为例）：

# 替换为你的NDK路径和对应架构的工具链
$NDK_PATH/toolchains/llvm/prebuilt/linux-x86_64/bin/i686-linux-android21-clang -shared -o libmylib.so -Wl,--whole-archive libmylib.a -Wl,--no-whole-archive

• 必须添加-shared参数明确指定生成动态库。
• 用--whole-archive参数确保静态库中的所有符号都被完整打包到动态库中，避免链接缺失。

3. 确认.so架构与运行环境匹配 #

• 用file libmylib.so命令查看文件的目标架构，比如x86架构应输出Intel 80386，arm64-v8a应输出ARM aarch64。
• 确保.so文件放在jniLibs对应的架构子目录下（如x86库放在src/main/jniLibs/x86/），NDK的abiFilters配置要与实际存在的库架构完全对应，避免架构不匹配导致加载失败。

4. 清理项目残留的损坏文件 #

• 执行./gradlew clean清理build目录，重新编译打包，避免旧的损坏.so文件被残留复用。
• 检查jniLibs目录下的.so文件是否被误修改（比如用文本编辑器打开保存过，导致二进制文件损坏），若有则替换为重新生成的文件。

5. 检查AndroidManifest配置 #

如果<application>标签中手动设置了android:extractNativeLibs="false"，需确保.so文件已完成正确的压缩对齐；若targetSdkVersion >=23，建议保持默认的true配置，避免因文件未解压导致加载异常。

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