React Native APK在Android 6.0真机启动崩溃（模拟器无报错）

问题背景 #

开发的React Native Expo应用，初期完成2个页面时生成APK安装到HTC Desire 10 Pro（Android 6.0）设备上可正常启动；但接近开发完成后，应用在闪屏结束后崩溃。使用Expo的JS调试器在Android Studio模拟器中调试未发现报错。

配置文件 #

package.json #

{
    "name": "f1ian",
    "version": "1.0.0",
    "main": "node_modules/expo/AppEntry.js",
    "scripts": {
        "start": "expo start",
        "android": "expo start --android",
        "ios": "expo start --ios",
        "web": "expo start --web"
    },
    "dependencies": {
        "@react-native-async-storage/async-storage": "1.17.11",
        "@react-navigation/bottom-tabs": "^6.5.7",
        "@react-navigation/drawer": "^6.6.2",
        "@react-navigation/native": "^6.1.6",
        "@react-navigation/stack": "^6.3.16",
        "axios": "^1.4.0",
        "expo": "~48.0.18",
        "expo-constants": "~14.2.1",
        "expo-status-bar": "~1.4.4",
        "expo-web-browser": "^12.1.1",
        "react": "18.2.0",
        "react-native": "0.71.8",
        "react-native-gesture-handler": "~2.9.0",
        "react-native-reanimated": "~2.14.4",
        "react-native-safe-area-context": "4.5.0"
    },
    "devDependencies": {
        "@babel/core": "^7.20.0"
    },
    "private": true
}

eas.json #

{
  "cli": {
    "version": ">= 3.6.0"
  },
  "build": {
    "development": {
      "developmentClient": true,
      "distribution": "internal",
      "ios": {
        "resourceClass": "m1-medium"
      }
    },
    "preview": {
      "distribution": "internal",
      "ios": {
        "resourceClass": "m1-medium"
      }
    },
    "production": {
      "ios": {
        "resourceClass": "m1-medium"
      }
    }
  },
  "submit": {
    "production": {}
  }
}

app.json #

{
    "expo": {
        "name": "f1ian",
        "slug": "f1ian",
        "version": "1.0.0",
        "orientation": "portrait",
        "icon": "./App/assets/icon.png",
        "userInterfaceStyle": "light",
        "splash": {
            "image": "./App/assets/splash.png",
            "resizeMode": "contain",
            "backgroundColor": "#ffffff"
        },
        "updates": {
            "fallbackToCacheTimeout": 0
        },
        "assetBundlePatterns": ["**/*"],
        "ios": {
            "supportsTablet": true
        },
        "android": {
            "package": "com.f1ian.f1ian",
            "versionCode": 1,
            "adaptiveIcon": {
                "foregroundImage": "./App/assets/adaptive-icon.png",
                "backgroundColor": "#FFFFFF"
            }
        },
        "web": {
            "favicon": "./App/assets/favicon.png"
        },
        "extra": {
            "eas": {
                "projectId": "f5f4f061-dc1b-46a3-9474-4ce7f3c8dc36"
            }
        }
    }
}

可能的崩溃原因及解决方案 #

1. Android 6.0（API 23）兼容性问题 #

Expo 48对应React Native 0.71.x，官方最低支持API 21，但部分依赖库在API 23上可能存在兼容性问题：

• react-native-reanimated 2.14.4依赖较新的ART运行时特性，Android 6.0的ART可能无法兼容，尝试降级到2.10.x版本测试。
• 检查是否使用了API 23以上才支持的系统API（如某些权限、硬件特性），或者第三方库内部依赖了高版本API。

2. 内存不足导致崩溃 #

随着功能增多，应用内存占用上升，HTC Desire 10 Pro的硬件配置可能无法支撑，Android 6.0的内存管理机制更容易触发OOM崩溃：

• 优化页面内存使用，比如及时卸载未使用的组件、减少不必要的全局状态、优化图片加载（压缩图片、使用懒加载）。
• 避免在主线程执行大量同步操作，防止阻塞导致ANR进而崩溃。

3. 原生层错误（JS调试器无法捕获） #

JS调试器只能捕获JS层错误，原生层崩溃（如JNI错误、原生库加载失败）需要通过设备日志定位：

• 连接设备到电脑，执行adb logcat | grep com.f1ian.f1ian过滤应用相关日志，查找AndroidRuntime开头的崩溃堆栈信息，明确具体错误原因。

4. 资源打包或加载问题 #

assetBundlePatterns设置为["**/*"]可能导致打包资源过大，或者某些资源在Android 6.0上无法正确加载：

• 检查是否使用了Android 6.0原生不支持的资源格式（如WebP），Expo虽有处理，但可能存在异常，尝试替换为PNG/JPG格式测试。
• 优化资源打包，只包含必要的资源，避免不必要的文件被打包。

5. 依赖库冲突或版本问题 #

后期新增的依赖可能与现有库存在版本冲突，或者某些库版本在Android 6.0上有bug：

• 检查新增依赖的兼容性，比如axios 1.4.0在旧Android系统的网络请求是否存在问题，可尝试降级到1.3.x版本测试。

是否需要删除package-lock.json？ #

不建议盲目删除package-lock.json，除非确定是依赖版本不一致导致的问题。删除后重新安装依赖可能会更新库版本，反而引入新的兼容性问题。如果怀疑依赖问题，可按以下步骤操作：

1. 清理Expo缓存：执行expo r -c
2. 备份package-lock.json后删除，执行npm install，但需注意测试版本变更后的稳定性。

调试建议 #

• 获取崩溃日志：使用adb logcat或Android Studio Logcat工具获取设备端的崩溃堆栈，这是定位原生层问题的核心。
• 最小化测试：创建简化版本的应用，逐步添加功能，定位导致崩溃的具体模块或页面。
• 权限检查：Android 6.0需要动态申请危险权限，确保应用中使用权限的功能（如网络、存储）已正确处理权限申请流程。

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