Expo React Native构建后iOS/Android闪屏后白屏问题排查

• 异步初始化逻辑未正确处理
  本地开发时资源可能已缓存，但构建包后首次加载异步操作（如字体加载、API初始化）失败且未捕获错误，导致渲染阻塞。检查：

  • 字体加载是否用try/catch包裹Font.loadAsync，确保加载失败时有 fallback 逻辑；
  • 使用expo-splash-screen时，是否正确调用preventAutoHideAsync，并在所有资源加载完成后才执行hideAsync，避免闪屏提前隐藏但页面未就绪；
  • 若用AppLoading组件，是否配置了onError回调处理加载失败的情况。

• 环境变量缺失或配置错误
  EAS构建的preview profile可能未正确注入环境变量，导致应用依赖的配置（如API地址、密钥）缺失，初始化时抛出未捕获错误。检查：

  • eas.json中preview profile是否配置了env字段，或是否正确关联了.env文件；
  • 代码中是否有依赖环境变量的逻辑，且未处理变量不存在的情况。

• 开发环境专属代码导致崩溃
  代码中若使用__DEV__等开发环境判断，构建preview版时会进入非开发分支，若分支代码存在逻辑错误（如未替换的mock数据、调试代码），会导致应用崩溃。检查：

  • 移除或修复非开发环境下的无效代码，比如确保生产/preview环境有可用的API请求逻辑，而非仅依赖本地mock；
  • 避免在非开发环境调用仅存在于开发工具的API。

• 资源路径或打包配置错误
  本地开发时资源路径可正常解析，但构建包后资源未被正确打包或路径错误，导致加载失败。检查：

  • app.json中fonts字段的路径是否正确，确保字体文件存在于指定目录；
  • 图片、字体等资源是否用require()正确引用，而非相对路径字符串；
  • EAS构建日志中是否有资源打包失败的警告或错误。

• SDK版本或模块兼容性问题
  本地SDK版本与EAS构建服务使用的版本不一致，或依赖模块存在版本冲突，导致构建后的应用运行时出错。检查：

  • package.json中Expo SDK版本与eas.json指定的版本是否一致；
  • 依赖模块是否存在版本冲突，可通过npm ls或yarn why排查；
  • 确认所有使用的Expo模块都支持当前SDK版本。

• 路由初始化错误
  若使用react-navigation，路由配置错误会导致初始页面无法渲染。检查：

  • 初始路由名称是否存在于导航配置中；
  • NavigationContainer是否正确包裹所有路由组件，且未在初始化时传递无效参数；
  • 路由组件是否存在未捕获的初始化错误（如未处理的props、状态异常）。

• 未捕获的全局错误
  构建包后错误不会像本地开发那样直观显示，未捕获的全局错误会导致应用卡住白屏。检查：

  • 用ErrorBoundary组件包裹根组件，捕获子组件的渲染错误；
  • 添加全局错误监听，比如：

    import { ErrorRecovery } from 'expo';
    ErrorRecovery.setRecoveryProps({ message: 'App crashed' });
    

  • 查看设备日志（iOS用Xcode控制台，Android用adb logcat），寻找崩溃或错误信息。

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