React Native Android应用安装成功后Metro断开，重载功能失效

DevOps 小满

2026-6-19

React Native重载失效、无应用连接问题排查方案

这个问题并非React Native 0.75.2或Metro的固有bug，而是设备连接、调试配置或启动逻辑层面的问题，以下是具体排查和解决步骤：

1. 手动启动APP并确认调试连接

由于设备后台限制等原因，run-android安装完成后可能不会自动启动APP，先手动打开设备上的myAppPackage应用
摇晃设备调出开发者菜单，若无法调出，需开启设备调试权限：
- 进入设备「设置」→「开发者选项」，开启「USB调试」和「仅充电模式下允许ADB调试」
- 执行命令建立端口反向代理：
```
adb reverse tcp:8081 tcp:8081
```

2. 验证设备与ADB的连接状态

在终端执行以下命令，确认Pixel 6设备处于device状态：
```
adb devices
```
若显示unauthorized，在设备弹出的「允许USB调试」对话框点击允许，重新执行上述命令
关闭当前Metro进程，重新启动并清除缓存：
```
npx react-native start --reset-cache
```

3. 检查APP的调试配置

打开android/app/src/main/AndroidManifest.xml，确保包含以下关键配置：

<uses-permission android:name="android.permission.INTERNET" />

<application
    ...
    android:usesCleartextTraffic="true"> <!-- 允许访问Metro明文HTTP服务 -->
    <activity
        ...
        android:exported="true"> <!-- RN 0.68+要求主Activity必须配置此属性 -->
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
</application>

打开android/app/build.gradle，确认devDebug构建类型开启调试：

buildTypes {
    devDebug {
        debuggable true
        minifyEnabled false
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}