Flutter运行报错：无法实例化MainActivity，ClassNotFoundException问题求助

第一步：执行全量构建缓存清理 #

之前强制中断构建进程大概率导致各级缓存损坏，优先做彻底清理：

• 项目根目录执行 flutter clean
• 删除android目录下的.gradle文件夹
• 删除android/app目录下的build文件夹
• 执行flutter pub get重新拉取项目依赖

第二步：检查MainActivity文件路径与内容 #

你使用的是Flutter 2.5.3稳定版，搭配V2版Embedding，不需要手动自定义复杂的MainActivity逻辑，只需要确认对应路径下存在正确的文件即可：

1. 先确认项目Android端使用的开发语言：
   • 如果是Kotlin项目，检查路径android/app/src/main/kotlin/com/example/coming_soon/下是否存在MainActivity.kt
   • 如果是Java项目，检查路径android/app/src/main/java/com/example/coming_soon/下是否存在MainActivity.java
2. 如果文件丢失，手动创建对应文件，内容分别为：
   Kotlin版本

   package com.example.coming_soon
   import io.flutter.embedding.android.FlutterActivity
   class MainActivity: FlutterActivity() {
   }
   

   Java版本

   package com.example.coming_soon;
   import io.flutter.embedding.android.FlutterActivity;
   public class MainActivity extends FlutterActivity {
   }
   

3. 确认目录层级与包名完全匹配：com.example.coming_soon对应三层目录com→example→coming_soon，层级错误也会导致类找不到。

第三步：重新构建运行 #

完成上述操作后，执行flutter run重新启动项目即可。
如果依然报错，可以在运行命令后添加--no-shrink参数临时关闭资源压缩，排除压缩误删类的问题。

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