Flutter项目AndroidManifest.xml出现未解析包、属性不允许等系列错误

核心成因 #

这类报错本质是IDE无法正确识别Flutter安卓项目的配置和依赖，常见触发原因如下：

• 项目未完成Gradle同步，安卓侧依赖（包括Flutter引擎、facebook登录这类第三方插件的原生依赖）未被IDE加载
• AndroidManifest.xml存放位置错误，误修改debug/profile目录下的清单文件，或者文件放错了层级
• Flutter项目安卓侧配置损坏，比如build.gradle配置错误、Flutter引擎下载不完整、第三方插件的原生配置未自动注入
• 项目缓存冲突，IDE索引缓存或Flutter构建缓存异常

排查修复步骤 #

1. 确认清单文件位置 #

你需要修改的主清单文件必须是android/app/src/main/AndroidManifest.xml，不要修改debug、profile目录下的清单文件，也不要修改build目录下自动生成的清单文件。

2. 清理缓存并拉取依赖 #

在项目根目录依次执行以下命令：

flutter clean
flutter pub get

完成后进入安卓目录刷新Gradle依赖：

cd android
# Mac/Linux执行
./gradlew clean build --refresh-dependencies
# Windows执行
gradlew.bat clean build --refresh-dependencies

3. 刷新IDE索引 #

• Android Studio：点击右上角Sync Project with Gradle Files按钮，同步完成后选择File > Invalidate Caches，勾选清除文件系统缓存和本地历史，重启IDE即可
• VS Code：关闭项目重新打开，执行Flutter: Clean Dart Project命令后重新运行项目

4. 修复第三方依赖报错 #

如果facebook相关类找不到，可先确认pubspec.yaml中facebook登录插件的版本和你的Flutter版本兼容，无版本冲突。问题仍存在的话可手动在android/app/build.gradle的dependencies块中添加依赖：

implementation 'com.facebook.android:facebook-android-sdk:latest.release'

同步Gradle后即可解决。

5. 检查清单文件语法结构 #

确认AndroidManifest.xml根节点包含正确的命名空间声明：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="你的应用包名">
    <!-- 其余配置 -->
</manifest>

同时确认属性放置位置正确：

• android:icon、android:usesCleartextTraffic必须放在<application>节点下
• launchMode、theme这类属性必须放在<activity>节点下
• scheme、host这类属性必须放在<intent-filter>下的<data>节点内
  属性放错位置就会触发「属性不允许在此处」的报错。

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