Flutter添加依赖后Android编译报错，无法确定任务依赖求解决

DevOps 小满

2026-6-16

针对Android端依赖报错的排查与解决步骤

以下是针对你遇到的shared_preferences、path_provider依赖导致Android端报错的具体解决方法：

检查AGP与Gradle版本兼容性
Android Gradle插件（AGP）和Gradle本身的版本不匹配是这类问题的常见原因。打开android/build.gradle查看com.android.tools.build:gradle的版本，再对应gradle-wrapper.properties里的distributionUrl版本，按照官方兼容关系调整。比如AGP 7.4.x对应Gradle 7.5及以上版本：
```
// android/build.gradle 中的AGP版本
dependencies {
    classpath 'com.android.tools.build:gradle:7.4.2'
}
```
```
// gradle-wrapper.properties 中的Gradle版本
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
```

彻底清理重建项目
缓存残留也会导致依赖冲突，执行以下命令：

flutter clean && flutter pub get
cd android && ./gradlew clean && ./gradlew build --refresh-dependencies

对齐依赖与Flutter SDK版本
确保使用的依赖版本和当前Flutter SDK稳定版兼容，在pubspec.yaml中指定最新稳定版依赖后执行升级：
```
dependencies:
  flutter:
    sdk: flutter
  shared_preferences: ^2.2.2
  path_provider: ^2.1.1
```
执行命令：
```
flutter pub upgrade
```
检查Android权限配置（针对path_provider）
如果是Android 13及以上版本，path_provider需要额外的媒体权限，在android/app/src/main/AndroidManifest.xml中添加：
```
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
```
修复Flutter SDK缓存
删除Flutter SDK目录下的bin/cache文件夹，然后运行flutter doctor重新初始化SDK缓存。