Flutter运行报错：Activity类{com.example.app_musique/...MainActivity}不存在

• 检查AndroidManifest.xml配置

  • 确认MainActivity的android:name属性值为com.example.app_musique.MainActivity，无拼写错误
  • 确保<activity>标签内包含正确的：

    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
    

• 清理构建缓存

  • 执行flutter clean清除Flutter缓存
  • 进入项目的android目录，执行./gradlew clean清除Gradle缓存
  • 重新执行flutter pub get后再编译安装

• 验证Flutter Android嵌入模式

  • 检查MainActivity.kt（或Java文件）是否继承自FlutterActivity，而非旧版嵌入相关类
  • 若使用的是v1嵌入模式，建议迁移到v2嵌入（确保MainActivity直接继承FlutterActivity，无需手动处理Delegate）

• 排查GrapheneOS系统设置

  • 进入设备设置→应用→目标应用，检查是否开启了应用组件隐藏或启动限制类选项
  • 打开开发者选项，尝试关闭严格模式或应用组件验证相关开关

• 检查APK组件声明

  • 执行aapt dump badging build/app/outputs/flutter-apk/app-debug.apk，查看输出中是否存在com.example.app_musique.MainActivity的声明
  • 确认编译时是否针对Pixel3a的架构（armv7）生成了正确的APK，避免架构不兼容导致组件无法识别

• 测试全新项目

  • 创建一个默认Flutter新项目，编译安装到Pixel3a，验证是否能正常启动
  • 若新项目正常，逐步迁移原项目代码到新项目中，定位具体问题点

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