Expo构建的React Native Android应用本地正常，生产环境卡在启动页如何排查

算力阿峰

2026-7-15

Expo React Native应用启动页卡顿排查步骤

1. 优化日志捕获策略

放弃仅过滤包名的方式，先抓取全局错误日志定位方向：
```
adb logcat *:E
```

针对React Native框架和JS层日志精准过滤（Windows环境注意引号用法）：

# Windows
adb logcat | findstr /C:"ReactNative" /C:"ReactNativeJS" /C:"MY.APPS.PACKAGE"
# macOS/Linux
adb logcat ReactNative:V ReactNativeJS:V MY.APPS.PACKAGE:V *:E

如果设备连接正常但日志为空，尝试重启ADB服务：
```
adb kill-server && adb start-server
```

2. 验证生产包的一致性

生成正式生产导出包，而非本地临时构建：
```
npx expo export --platform android
```
找到导出的APK文件，手动安装到设备测试，排除本地--no-dev --minify模式的特殊缓存影响
仔细查看导出过程中的所有警告，重点关注资源引用（如图片、字体）、依赖缺失等提示

3. 排查启动阶段代码逻辑

逐步注释App.tsx中启动时的异步操作（如SDK初始化、接口请求、本地存储读取），定位具体阻塞点
确认生产环境严格模式状态：检查app.json中expo.strictMode配置，生产环境默认关闭，若手动开启可能引发未预期的初始化问题

添加全局错误捕获，留存运行时错误信息：

import { ErrorUtils } from 'react-native';
import AsyncStorage from '@react-native-async-storage/async-storage';

ErrorUtils.setGlobalHandler(async (error, isFatal) => {
  const errorMsg = `[${new Date().toISOString()}] ${isFatal ? 'Fatal' : 'Error'}: ${JSON.stringify(error)}`;
  console.error(errorMsg);
  // 将错误写入本地存储，后续可导出查看
  await AsyncStorage.setItem('launch_error', errorMsg);
});