React Native报错：com.myapp.MainActivity无法转换为AppCompatActivity

检查MainActivity继承关系 #

• 打开android/app/src/main/java/com/myapp/MainActivity.java（或Kotlin文件），确认MainActivity继承自androidx.appcompat.app.AppCompatActivity，而非旧版的Activity或ActionBarActivity。正确代码示例：

  import androidx.appcompat.app.AppCompatActivity;
  
  public class MainActivity extends AppCompatActivity {
      // 原有代码逻辑
  }
  

  Kotlin版本：

  import androidx.appcompat.app.AppCompatActivity
  
  class MainActivity : AppCompatActivity() {
      // 原有代码逻辑
  }
  

彻底清理缓存并重新编译 #

• 执行以下命令清理所有缓存：

  # 清理React Native项目缓存
  npx react-native clean
  # 清理Android构建缓存
  cd android && ./gradlew clean && cd ..
  

• 之后重新运行指定构建命令：

  npx react-native run-android --variant TstDebug --appId AppTst --appIdSuffix "tst" --port 8084
  

验证gradle配置一致性 #

• 确保android/gradle.properties中的AndroidX配置未被篡改：

  android.useAndroidX=true
  android.enableJetifier=true
  

• 检查android/app/build.gradle中是否正确引入AndroidX依赖，示例：

  dependencies {
      implementation 'androidx.appcompat:appcompat:1.3.1'
      // 其他依赖项
  }
  

  版本号可根据RN 0.63.3的兼容情况调整，避免版本冲突。

检查TstDebug变体配置 #

• 打开android/app/build.gradle，确认TstDebug对应的productFlavors或buildTypes配置中，没有单独覆盖AndroidX相关设置（比如设置android.useAndroidX=false）。

清理设备残留数据 #

• 彻底卸载应用后，进入设备「设置-应用-已安装应用」，确认无同名/同包名的残留应用；如果使用模拟器，可重置模拟器状态，避免缓存数据干扰。

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