Flutter集成Firebase失败：POM文件解析错误求助

问题现象 #

构建时出现多个POM文件解析错误，提示「序言中不允许包含内容」，具体错误日志如下：

[Fatal Error] concurrent-futures-1.1.0.pom:2:1: 序言中不允许包含内容。
[Fatal Error] firebase-annotations-16.2.0.pom:2:1: 序言中不允许包含内容。
[Fatal Error] play-services-basement-18.1.0.pom:2:1: 序言中不允许包含内容。
[Fatal Error] play-services-tasks-18.0.2.pom:2:1: 序言中不允许包含内容。

最终导致:app:checkDebugAarMetadata任务执行失败，Gradle构建退出码1。

解决方案 #

1. 清理本地Gradle缓存 #

该错误大多由缓存的POM文件损坏导致，优先清理缓存：

• 执行Flutter清理命令：

  flutter clean
  

• 手动删除系统Gradle缓存目录：
  • Windows：C:\Users\<你的用户名>\.gradle\caches
  • macOS/Linux：~/.gradle/caches

2. 修复Flutter依赖缓存 #

执行命令修复本地Pub缓存的依赖文件：

flutter pub cache repair

重新获取依赖：

flutter pub get

3. 检查并更新Firebase依赖版本 #

打开项目根目录的pubspec.yaml，确保Firebase相关依赖使用最新稳定版，示例：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: ^2.15.0 # 替换为最新稳定版

可通过flutter pub outdated命令查看可更新的依赖版本。

4. 验证Android端Gradle配置 #

打开android/build.gradle文件，确认Google Maven仓库已正确配置：

allprojects {
    repositories {
        google()
        mavenCentral()
    }
}

同时确保Gradle插件版本与Gradle wrapper版本兼容。

5. 强制刷新IDE缓存 #

若使用Android Studio/IntelliJ：

• 点击菜单栏 File -> Invalidate Caches / Restart
• 选择 Invalidate and Restart 选项，重启IDE后重新构建

原因分析 #

这类错误通常由以下情况引发：

• 依赖下载时网络不稳定，导致POM文件不完整或损坏
• 本地Gradle缓存文件过期、损坏
• Firebase依赖版本不兼容，引发依赖链解析异常

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