Flutter构建release版APK安装后无法打开、无图标问题求助

问题现象 #

为构建可交付测试的APK安装包，耗时一整晚重装排查Android Studio、VS Code与Flutter环境。手机连接电脑执行debug调试时应用运行完全正常，原以为打包流程会顺利推进，实际遇到持续无法解决的异常：
按官方部署流程操作、解决所有构建报错后成功生成APK，传输到手机完成安装后，安装完成弹窗的「打开」按钮呈灰色不可点击状态，无法启动应用。

已尝试排查操作 #

• 将targetSdkVersion下调至适配测试手机的Android系统版本
• 尝试构建全CPU架构版本的APK与AppBundle
• 正确配置key.properties文件，使用keytool生成签名密钥
• 关闭Google Play Protect防护
• 确认测试手机开启开发者模式，已允许安装未知来源应用

当前异常状态 #

应用可正常安装，但桌面不生成任何启动图标；退出安装弹窗后仅能在系统设置的应用列表中找到该应用，且应用详情页的「强制停止」按钮也为灰色不可点击状态，应用完全无法使用。

debug模式下Android Studio会自动注入临时启动配置，因此debug运行完全正常；release包完全依赖开发者在Manifest中声明的配置，只要系统识别不到合法的应用启动入口，就会出现上述所有异常表现。

优先级最高的排查点（90%同类问题根因） #

打开项目路径下的android/app/src/main/AndroidManifest.xml，找到主Activity（通常为.MainActivity）节点，检查其内部的<intent-filter>配置：

1. 必须同时存在以下两行配置，缺一不可：

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

2. 主Activity节点必须配置android:exported="true"，Android 12及以上版本未配置该属性会导致系统无法拉起启动页。

其他可能的异常原因 #

• 若配置了多渠道、多构建变体，检查对应变体目录下的Manifest文件是否在合并时覆盖了主Manifest的启动入口配置；部分第三方集成插件配置不当，也会在Manifest合并阶段误删LAUNCHER分类声明
• 检查<application>节点是否误加android:enabled="false"属性，该属性会直接标记整个应用为不可启动状态
• 若之前为适配闪屏、深链修改过intent-filter，确认没有将MAIN、LAUNCHER属性误移到其他非启动Activity的节点下

修复配置后，依次执行flutter clean、flutter pub get后重新构建release包，先卸载手机上已安装的异常版本，再安装新包即可恢复正常。

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