Flutter引入shared_preferences后Gradle构建失败求助

问题本质 #

错误源于kotlin-compiler-30.3.0.jar依赖包下载不完整（预期接收40,346,136字节，实际仅收到8,650,688字节），属于Gradle缓存损坏或网络中断导致的依赖缺失，并非shared_preferences本身存在问题，只是引入该依赖触发了缺失依赖的下载流程。

修复步骤 #

• 清理Gradle缓存
  找到项目android目录下的.gradle文件夹直接删除；或是在项目根目录终端执行命令：

  ./gradlew cleanBuildCache
  

• 重新构建项目
  重启IDE后执行构建命令，让Gradle重新完整下载依赖：

  flutter run
  

• 排查网络问题
  若清理缓存后仍失败，检查网络稳定性，切换至更稳定的网络环境，确保能完整下载大体积依赖文件。

• 配置国内镜像（可选）
  若因网络访问限制导致下载失败，修改项目android/build.gradle的镜像源配置：

  buildscript {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          mavenCentral()
      }
  }
  
  allprojects {
      repositories {
          maven { url 'https://maven.aliyun.com/repository/google' }
          maven { url 'https://maven.aliyun.com/repository/jcenter' }
          mavenCentral()
      }
  }
  

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