React Native升级至0.69+后Android端构建成功但无内容显示求助

问题描述 #

• 升级至React Native 0.69.7后，构建成功但应用打开无内容显示（黑屏），降级到0.68.5恢复正常，0.69及以上版本问题复现
• 已按照React Native Upgrade Helper完成升级操作
• Metro Bundle无日志输出，应用内所有网络请求无法执行，原本需执行Codepush更新的区域因请求卡住导致黑屏
• 仅Android端出现该问题

环境信息 #

• React Native: 0.69.7
• Android OS Version: 10.0.0
• Gradle Plugin Version: 7.1.1
• Gradle Version: 7.3.0
• JDK Version: 10.0.16
• JRE Version: 1.8.0_341

可能的原因分析 #

1. Android 10网络安全配置拦截HTTP请求 #

RN 0.69开始，针对Android 9+默认关闭了明文流量允许（cleartextTrafficPermitted=false）。如果你的Codepush服务器或业务接口使用HTTP协议，会直接被系统拦截，导致Codepush初始化失败，应用卡在启动阶段黑屏。

• 排查点：检查AndroidManifest.xml的<application>标签是否配置了android:usesCleartextTraffic="true"；或者是否存在res/xml/network_security_config.xml，确认其中是否允许了目标HTTP域名的明文访问。

2. Metro Bundle加载异常 #

RN 0.69对Metro的配置逻辑有调整，可能存在以下问题：

• metro.config.js配置错误：比如resolver的路径规则、transformer设置不符合0.69的要求，导致Bundle无法正常生成或加载，应用启动后无内容渲染。
• 缓存残留：旧的Metro缓存未清理，新Bundle无法生效。执行npx react-native start --reset-cache重启Metro试试。
• Android端Bundle路径配置错误：检查android/app/build.gradle中bundleInDebug、bundleInRelease的配置，确认是否正确指向Metro生成的Bundle文件。

3. Codepush版本与RN 0.69不兼容 #

如果react-native-code-push版本未同步升级，会和RN 0.69的Native层逻辑冲突，初始化失败后阻塞应用启动流程：

• 确认react-native-code-push版本：至少升级到v7.0+版本（该版本开始支持RN 0.69及以上）。
• 检查Codepush初始化时机：如果在RN环境未就绪时就执行Codepush更新请求，会导致卡住，建议将Codepush初始化放在RN启动完成后的生命周期中。

4. JDK版本不兼容 #

RN 0.69开始对JDK 11有更好的支持，当前使用的JDK 10可能存在兼容性问题：

• 尝试将JDK版本升级到11，重新构建项目，看是否解决问题。

5. Android原生层视图渲染或生命周期异常 #

RN 0.69对ReactActivity、ReactNativeHost的逻辑有调整，自定义原生代码未适配会导致视图无法渲染：

• 检查是否自定义了ReactActivityDelegate，确认createRootView方法是否正确实现，确保RootView能正常挂载。
• 查看Android Studio的Logcat日志：过滤ReactNative、CodePush相关标签，排查是否有未捕获的原生异常导致启动流程中断。

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