添加firebase_storage后Flutter项目编译报错：cloud_firestore配置失败

核心错误分析 #

报错提示的无法获取未知属性‘android’、找不到implementation()方法，本质是Firebase插件间版本不兼容，或Android Gradle插件与Gradle版本不匹配，导致cloud_firestore模块的Gradle配置解析失败，同时伴随缓存Jar文件创建异常。

解决步骤 #

• 强制统一Firebase依赖版本
  在项目根目录的android/build.gradle文件中，找到allprojects块，添加配置强制使用Firebase BOM（物料清单）统一版本，避免插件间版本冲突：

  allprojects {
      repositories {
          // 保留原有仓库配置
      }
      configurations.all {
          resolutionStrategy {
              // 使用最新稳定版Firebase BOM，可根据插件版本调整
              force 'com.google.firebase:firebase-bom:32.7.0'
              force 'com.google.android.gms:play-services-base:18.2.0'
          }
      }
  }
  

• 匹配Android Gradle插件与Gradle版本

  1. 打开android/build.gradle，确保classpath中的Android Gradle插件版本与Gradle版本对应：

     buildscript {
         dependencies {
             // 示例：插件7.4.2对应Gradle 7.5，可根据Flutter版本调整
             classpath 'com.android.tools.build:gradle:7.4.2'
             classpath 'com.google.gms:google-services:4.4.0'
         }
     }
     

  2. 打开android/gradle/wrapper/gradle-wrapper.properties，修改distributionUrl匹配对应Gradle版本：

     distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
     

• 彻底清理缓存并重新拉取依赖

  1. 执行命令清理Flutter和Gradle缓存：

     flutter clean
     # Windows用户直接删除C:\Users\<你的用户名>\.gradle\caches文件夹
     flutter pub get
     

  2. 删除本地插件缓存，重新拉取：
     找到Flutter pub缓存目录（通常是flutter/.pub-cache/hosted/pub.dartlang.org/），删除cloud_firestore-xxx、firebase_storage-xxx、firebase_core-xxx文件夹，再执行flutter pub get

• 检查pubspec.yaml依赖版本
  确保所有Firebase依赖使用最新稳定版，示例配置：

  dependencies:
    flutter:
      sdk: flutter
    firebase_core: ^2.24.2
    cloud_firestore: ^4.14.0
    firebase_storage: ^11.6.0
  

• 验证Android模块配置
  打开android/app/build.gradle，确保：

  • 顶部存在apply plugin: 'com.android.application'，且apply plugin: 'com.google.gms.google-services'放在配置最后
  • android块中compileSdkVersion至少为33，minSdkVersion不低于21（符合Firebase插件要求）

内容的提问来源于stack exchange，提问作者Syed Ammar Bin Farrukh