跟随Flutter官方Android Java教程时遇MainActivity类找不到错误

我在VSCode中跟随Flutter官方平台通道的Android Java教程操作，将生成的应用在Android模拟器运行时，调试控制台出现如下错误：

Launching lib/main.dart on sdk gphone64 x86 64 in debug mode...
lib/main.dart:1
✓  Built build/app/outputs/flutter-apk/app-debug.apk.
E/AndroidRuntime(20503): FATAL EXCEPTION: main
E/AndroidRuntime(20503): Process: com.example.native_code, PID: 20503
E/AndroidRuntime(20503): java.lang.RuntimeException: Unable to instantiate activity ComponentInfo{com.example.native_code/com.example.native_code.MainActivity}: java.lang.ClassNotFoundException: Didn't find class "com.example.native_code.MainActivity" on path: DexPathList[[zip file "/data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/base.apk"],nativeLibraryDirectories=[/data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/lib/x86_64, /data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/base.apk!/lib/x86_64, /system/lib64, /system_ext/lib64]]
E/AndroidRuntime(20503):    at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3545)
E/AndroidRuntime(20503):    at android.app.ActivityThread.handleLaunchActivity(ActivityThread.java:3792)
E/AndroidRuntime(20503):    at android.app.servertransaction.LaunchActivityItem.execute(LaunchActivityItem.java:103)
E/AndroidRuntime(20503):    at android.app.servertransaction.TransactionExecutor.executeCallbacks(TransactionExecutor.java:135)
E/AndroidRuntime(20503):    at android.app.servertransaction.TransactionExecutor.execute(TransactionExecutor.java:95)
E/AndroidRuntime(20503):    at android.app.ActivityThread$H.handleMessage(ActivityThread.java:2210)
E/AndroidRuntime(20503):    at android.os.Handler.dispatchMessage(Handler.java:106)
E/AndroidRuntime(20503):    at android.os.Looper.loopOnce(Looper.java:201)
E/AndroidRuntime(20503):    at android.os.Looper.loop(Looper.java:288)
E/AndroidRuntime(20503):    at android.app.ActivityThread.main(ActivityThread.java:7839)
E/AndroidRuntime(20503):    at java.lang.reflect.Method.invoke(Native Method)
E/AndroidRuntime(20503):    at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:548)
E/AndroidRuntime(20503):    at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1003)
E/AndroidRuntime(20503): Caused by: java.lang.ClassNotFoundException: Didn't find class "com.example.native_code.MainActivity" on path: DexPathList[[zip file "/data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/base.apk"],nativeLibraryDirectories=[/data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/lib/x86_64, /data/app/~~F9RZ4FuGVegZ1eIHByi9SQ==/com.example.native_code-tPV5CAJBY7lCnlthNyTpZA==/base.apk!/lib/x86_64, /system/lib64, /system_ext/lib64]]
E/AndroidRuntime(20503):    at dalvik.system.BaseDexClassLoader.findClass(BaseDexClassLoader.java:218)
E/AndroidRuntime(20503):    at java.lang.ClassLoader.loadClass(ClassLoader.java:379)
E/AndroidRuntime(20503):    at java.lang.ClassLoader.loadClass(ClassLoader.java:312)
E/AndroidRuntime(20503):    at android.app.AppComponentFactory.instantiateActivity(AppComponentFactory.java:95)
E/AndroidRuntime(20503):    at androidx.core.app.CoreComponentFactory.instantiateActivity(CoreComponentFactory.java:45)
E/AndroidRuntime(20503):    at android.app.Instrumentation.newActivity(Instrumentation.java:1273)
E/AndroidRuntime(20503):    at android.app.ActivityThread.performLaunchActivity(ActivityThread.java:3532)
E/AndroidRuntime(20503):    ... 12 more

可能原因 #

• MainActivity.java文件的实际存放路径与AndroidManifest中声明的包名不匹配
• Flutter或Android Gradle的编译缓存未更新，导致类未被正确打包进APK
• 若开启了代码混淆，MainActivity被误加入混淆规则导致被移除
• 手动修改项目包名后，Manifest文件或Java类中的包名未同步更新

解决步骤 #

• 检查路径与包名一致性

  1. 确认android/app/src/main/java/com/example/native_code/MainActivity.java文件存在，文件开头的package com.example.native_code;声明正确
  2. 打开android/app/src/main/AndroidManifest.xml，确认<activity>标签的android:name属性为.MainActivity或完整路径com.example.native_code.MainActivity

• 清理并重建项目

  1. 在终端执行：flutter clean
  2. 接着执行：flutter pub get
  3. 最后重新运行：flutter run

• 清理Gradle缓存

  1. 进入项目的android/目录，执行./gradlew clean（Windows系统执行gradlew clean）
  2. 重启VSCode，关闭残留的编译进程后再重新构建

• 检查混淆规则（若启用）
  打开android/app/proguard-rules.pro，添加规则：-keep class com.example.native_code.MainActivity { *; }，确保MainActivity不被混淆移除

• 重置模拟器状态
  重启Android模拟器，或进入设备设置→应用→找到对应应用→存储→清空缓存后重新运行

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