React Native安卓端脱离CLI启动卡在Splash-screen问题求助

故障常见根因 #

1. 安卓端原生层SplashScreen初始化配置错误，调用时序不符合要求
2. JS层SplashScreen.hide()方法被阻塞，未正常触发：常见于将hide逻辑放在网络请求、异步存储读取等可能失败、超时的异步回调中，或是启动阶段JS代码报错导致后续逻辑中断
3. 构建缓存异常导致release包中JS Bundle打包不全，启动后逻辑无法正常执行

解决方案 #

1. 修正安卓原生层配置 #

检查MainActivity.java的onCreate方法，确保SplashScreen的调用时序正确，示例代码如下：

import android.os.Bundle;
import org.devio.rn.splashscreen.SplashScreen;
import com.facebook.react.ReactActivity;

public class MainActivity extends ReactActivity {
  @Override
  protected void onCreate(Bundle savedInstanceState) {
    // 必须放在super.onCreate之前，位置写反会导致冷启动卡启动页
    SplashScreen.show(this);
    super.onCreate(savedInstanceState);
  }

  // 其余原有逻辑保持不变
}

同时检查AndroidManifest.xml中MainActivity的android:theme属性，确认配置的是你自定义的闪屏页主题，没有写错引用。

2. 调整JS层hide调用时机 #

不要将SplashScreen.hide()放在任何异步逻辑的回调中，直接在根组件挂载完成后立即调用，避免被阻塞：

import SplashScreen from 'react-native-splash-screen';
import { useEffect } from 'react';

export default function App() {
  useEffect(() => {
    // 优先执行hide，再处理其他初始化逻辑
    SplashScreen.hide();
    // 后续的用户信息拉取、初始化配置等异步逻辑放到hide之后执行
  }, []);

  // 其余渲染、逻辑代码保持不变
}

3. 排查启动阶段JS报错 #

连接安卓设备开启USB调试，手动打开应用后执行以下命令查看运行日志，确认是否有未捕获的JS异常导致代码中断：

adb logcat *:S ReactNative:V ReactNativeJS:V

如果存在报错，修复对应问题后重新测试即可。

4. 清理构建缓存重新打包 #

如果是release包出现问题，先清理旧的构建缓存再重新打包：

cd android
./gradlew clean
cd ..
# 重新打包release APK

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