Android平台libreactnativejni.so缺失AAsset_close符号问题求助

核心原因 #

• RN与NDK版本不兼容：libreactnativejni.so编译时依赖特定NDK版本的符号导出规则，若NDK版本偏离RN官方推荐范围，会导致AAsset_close这类标准NDK符号无法被运行时解析。
• 链接配置遗漏：编译JNI库时未显式链接libandroid.so（需添加-landroid链接标志），导致运行时无法找到AAsset_close的实现。
• 编译与运行环境不匹配：虽然AAsset_close从API Level 9开始提供，但如果项目minSdkVersion设置过低，或使用高版本NDK的编译特性，可能在低版本系统上出现符号缺失（RN项目中此情况罕见，因RN通常要求minSdk≥16）。

RN与NDK版本的已知兼容性问题 #

React Native官方对NDK版本有严格要求，不匹配会触发符号查找错误：

• RN 0.60.x ~ 0.63.x：推荐NDK 20.x
• RN 0.64.x ~ 0.70.x：推荐NDK 21.x
• RN 0.71+：推荐NDK 25.x及以上
  使用不符合要求的NDK版本，会导致RN的JNI库编译时符号绑定异常，进而引发运行时符号缺失。

解决步骤 #

1. 匹配RN版本对应的NDK版本 #

在android/build.gradle中指定官方推荐的NDK版本：

buildscript {
    ext {
        ndkVersion = "25.2.9519653" // 替换为你的RN版本对应的推荐NDK版本
    }
    // 其他配置...
}

2. 确保JNI编译时链接libandroid.so #

若项目包含自定义JNI模块，检查编译配置：

• CMakeLists.txt：添加android到链接库列表

target_link_libraries(
    your-native-library-name
    android
    log
    reactnativejni
    # 其他依赖库...
)

• Android.mk：添加链接标志

LOCAL_LDLIBS += -landroid -llog

3. 验证构建配置 #

• 确认android/app/build.gradle中的minSdkVersion符合RN版本要求（例如RN 0.71+要求minSdk≥21）。
• 检查ABI过滤，确保覆盖目标设备架构：

android {
    defaultConfig {
        ndk {
            abiFilters "armeabi-v7a", "arm64-v8a", "x86", "x86_64"
        }
    }
}

4. 深度清理并重构 #

执行以下命令彻底清理缓存后重新构建：

# 清理Node.js依赖
rm -rf node_modules package-lock.json yarn.lock
npm install

# 清理Android构建缓存
cd android
./gradlew clean
rm -rf .gradle build
cd ..

# 重新构建应用
npx react-native run-android

5. 排查第三方依赖兼容性 #

若项目使用第三方原生库，确认其NDK版本与RN项目一致，避免混合版本导致的符号冲突。

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