Flutter Android端启动报错：MainActivity类未找到求助

核心错误 #

java.lang.ClassNotFoundException: Didn't find class "com.robyhub.admin.MainActivity"

解决方案 #

• 检查AndroidManifest.xml配置
  确认android/app/src/main/AndroidManifest.xml中MainActivity的包名路径与实际代码完全一致，示例正确配置：

  <activity
      android:name="com.robyhub.admin.MainActivity"
      android:exported="true"
      android:theme="@style/LaunchTheme">
      <intent-filter>
          <action android:name="android.intent.action.MAIN"/>
          <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
  </activity>
  

  同时验证MainActivity文件位置是否为android/app/src/main/kotlin/com/robyhub/admin/MainActivity.kt（或Java对应目录），包名声明与路径匹配。

• 启用MultiDex支持
  若应用方法数超过限制或运行在Android 6.0以下设备，在android/app/build.gradle中配置：

  android {
      defaultConfig {
          ...
          multiDexEnabled true
      }
  }
  
  dependencies {
      implementation 'androidx.multidex:multidex:2.0.1'
  }
  

  并在Manifest中指定MultiDexApplication：

  <application
      android:name="androidx.multidex.MultiDexApplication"
      ...>
  

• 深度清理Android端缓存
  除flutter clean外，清理Gradle缓存后重建：

  cd android
  ./gradlew clean
  cd ..
  flutter build apk
  

• 验证版本兼容性
  确保pubspec.yaml中的Flutter版本与android/build.gradle内的Gradle插件版本兼容（如Flutter 3.x需Gradle插件7.0+），避免因版本不匹配导致编译异常。

• 排查代码混淆规则
  若开启了混淆，在android/app/proguard-rules.pro中保留MainActivity：

  -keep class com.robyhub.admin.MainActivity { *; }
  

  或临时禁用混淆，测试是否解决问题。

内容的提问来源于stack exchange，提问作者Paul Sola-Eniolawun