React Native从0.63.0升级到0.70.0后应用崩溃问题求助

核心解决方案 #

• 清理全链路缓存

  • Android端：执行./gradlew clean，删除项目根目录的.gradle、android/.gradle、android/build、android/app/build文件夹
  • React Native侧：执行npx react-native clean，删除node_modules后重装依赖：rm -rf node_modules && npm install

• 对齐NDK版本

  • 打开android/build.gradle，确保指定的NDK版本与RN 0.70要求一致（RN 0.70默认依赖NDK 25.1.8937393）
  • 同步Gradle配置后重新构建项目

• 排查第三方Native模块兼容性

  • 梳理项目中所有Native模块（含自定义.so库），确认它们已适配RN 0.70的Native API变更
  • 对未适配的模块，要么升级到兼容版本，要么临时移除后测试是否仍崩溃

• 重构自定义JNI代码（若有）

  • 若项目包含自定义JNI逻辑，使用RN 0.70的最新头文件重新生成绑定
  • 检查CMakeLists.txt或Android.mk，确保RN库的链接路径正确

错误原因解析 #

这个崩溃是Native库符号依赖不匹配导致的：libsampleapp_appmodules.so编译时依赖了RN Native层的enablePropIteratorSetter符号，但RN 0.63到0.70的Native架构经过大幅重构，该符号已被移除或重命名。即便你的代码未直接使用该符号，第三方模块或旧的JNI绑定可能存在隐式依赖。

验证方法 #

• 执行npx react-native run-android --variant=debug，查看构建日志是否有符号相关警告
• 使用命令nm -D libsampleapp_appmodules.so | grep enablePropIteratorSetter检查该符号是否被引用（有输出则说明存在隐式依赖）

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