Flutter新手求助：build.gradle问题排查与解决方法

• 清理项目缓存
  执行以下命令彻底清理缓存，解决大部分缓存引发的构建问题：

  flutter clean
  rm -rf android/.gradle android/build ios/Pods ios/Podfile.lock
  flutter pub get
  cd ios && pod install && cd ..
  

• 校验Gradle版本兼容性
  打开android/build.gradle文件，确保Gradle插件版本与本地Flutter SDK版本匹配（可参考Flutter官方文档对应版本要求）：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2' // 示例版本，按需调整
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
  }
  

  同步检查android/gradle/wrapper/gradle-wrapper.properties中的Gradle分发版本，需与插件版本对应：

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

• 检查Android配置参数
  打开android/app/build.gradle，确认编译、最小、目标SDK版本符合Flutter要求，避免版本不兼容：

  android {
      compileSdkVersion 33 // 示例版本，根据Flutter版本调整
      defaultConfig {
          minSdkVersion 21
          targetSdkVersion 33
          versionCode flutterVersionCode.toInteger()
          versionName flutterVersionName
      }
  }
  

• 修复仓库与网络问题
  确保build.gradle中的maven仓库配置正确，若在国内环境可添加镜像仓库加速：

  repositories {
      google()
      mavenCentral()
      // 国内环境可选添加阿里云镜像
      maven { url 'https://maven.aliyun.com/repository/google' }
      maven { url 'https://maven.aliyun.com/repository/public' }
  }
  

• 重置Android Studio状态
  打开Android Studio，执行File > Invalidate Caches...，选择Invalidate and Restart，重启后重新构建项目。

• 获取详细错误日志
  执行构建命令时添加--verbose参数，定位具体故障点：

  flutter build apk --verbose
  

  根据日志中的错误提示（如依赖冲突、权限缺失、资源引用错误等）针对性修复。

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