React Native项目在Android Studio启动失败：MainActivity类不存在

问题现象 #

构建耗时4分31秒完成，72个任务中2个执行、70个已是最新状态，连接开发服务器（端口8081）、尝试在emulator-5554模拟器启动应用时，抛出错误：

错误类型3：Error: Activity class {com.amicomponents/com.amicomponents.MainActivity} does not exist。

排查与解决方案 #

• 检查AndroidManifest.xml的Activity声明
  打开android/app/src/main/AndroidManifest.xml，确认MainActivity的配置是否正确，包名与类名需匹配：

  <activity
      android:name=".MainActivity"
      android:label="@string/app_name"
      android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|screenSize|smallestScreenSize|uiMode"
      android:launchMode="singleTask"
      android:windowSoftInputMode="adjustResize">
      <intent-filter>
          <action android:name="android.intent.action.MAIN" />
          <category android:name="android.intent.category.LAUNCHER" />
      </intent-filter>
  </activity>
  

  同时确保MainActivity的实际文件路径为android/app/src/main/java/com/amicomponents/MainActivity.java（或.kt文件），文件顶部的包声明为package com.amicomponents;。

• 清理缓存并重新构建
  执行以下命令清除项目缓存与旧构建文件，再重新运行：

  # 重置React Native缓存
  npx react-native start --reset-cache
  # 清理Android构建产物
  cd android && ./gradlew clean && cd ..
  # 重新构建并启动应用
  npx react-native run-android
  

• 卸载旧应用后重新安装
  先卸载模拟器中已存在的同包名应用，再重新构建：

  adb uninstall com.amicomponents
  npx react-native run-android
  

• 确认包名一致性
  检查android/app/build.gradle中的applicationId是否为com.amicomponents：

  defaultConfig {
      applicationId "com.amicomponents"
      minSdkVersion rootProject.ext.minSdkVersion
      targetSdkVersion rootProject.ext.targetSdkVersion
      versionCode 1
      versionName "1.0"
  }
  

  保证该值与AndroidManifest、Activity文件的包名完全一致。

• 重启模拟器
  关闭当前模拟器后重新启动，避免模拟器自身缓存或状态异常导致应用安装失败。

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