React Native iOS端Splash Screen（启动页）无法隐藏问题求助

• 检查AppDelegate.mm原生逻辑

  • 确认didFinishLaunchingWithOptions中是否正确初始化启动页，比如[RNSplashScreen show];是否只在启动时调用一次
  • 排查是否误写了重复调用show()的逻辑，或者注释掉了本该触发的hide()操作
  • 确保没有在原生层添加阻止启动页隐藏的逻辑，比如某些异步任务阻塞了主线程

• 验证App.tsx中的useEffect执行情况

  • 确保useEffect是无依赖的（useEffect(() => {}, [])），保证组件挂载时仅执行一次隐藏操作
  • 检查启动页库的hide方法是否正确导入，比如：

    import { hide } from 'react-native-splash-screen';
    

  • 在useEffect内添加日志打印，确认代码是否执行：

    useEffect(() => {
      console.log('Trying to hide splash screen');
      hide();
    }, []);
    

    通过Xcode控制台或React Native Debugger查看日志，判断这段代码是否被触发

• 排查依赖兼容性与安装问题

  • 确认使用的启动页库版本和当前React Native版本匹配，比如RN 0.70+需要对应库的适配版本
  • 尝试重新安装依赖并更新Pods：

    npm uninstall react-native-splash-screen
    npm install react-native-splash-screen
    cd ios && pod install && cd ..
    

• 检查iOS项目启动页配置

  • 打开Xcode，确认Launch Screen.storyboard在项目General->App Icons and Launch Images中被正确选中
  • 排查是否有其他第三方库（比如权限请求、监控类库）阻塞了UI线程，导致启动页隐藏操作被延迟或中断

• 原生侧直接测试隐藏操作

  • 在AppDelegate.mm的didFinishLaunchingWithOptions方法末尾直接添加[RNSplashScreen hide];，如果启动页能正常隐藏，说明问题出在RN侧的useEffect未执行；如果仍无法隐藏，说明原生配置存在问题

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