Flutter启动Android模拟器报错：无法打开cp_proj通用类缓存

云上老周

2026-7-22

Flutter项目Android端Gradle缓存与版本兼容问题解决

这个错误是Gradle缓存损坏，或是Gradle、Android Gradle Plugin（AGP）、Kotlin版本与当前Flutter版本不兼容导致的Groovy语法解析异常。以下是具体解决步骤：

清理Gradle缓存
手动删除项目根目录下的.gradle文件夹、android/.gradle文件夹以及build、android/build目录；也可执行命令：
```
flutter clean
rm -rf .gradle android/.gradle build android/build
```
Windows用户使用：
```
flutter clean
Remove-Item -Recurse -Force .gradle, android/.gradle, build, android/build
```

调整Gradle相关版本适配
编辑android/build.gradle文件，更新AGP和Kotlin版本，确保与当前Flutter版本匹配（例如Flutter 3.10+建议使用AGP 7.4.2及以上、Kotlin 1.8.x）：

buildscript {
    ext.kotlin_version = '1.8.20'
    repositories {
        google()
        mavenCentral()
    }

    dependencies {
        classpath 'com.android.tools.build:gradle:7.4.2'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
        classpath 'com.google.gms:google-services:4.4.0' // 同步更新到兼容版本
    }
}

检查pubspec.yaml的SDK版本
确保pubspec.yaml中environment的sdk版本与当前Flutter版本匹配，比如Flutter 3.16对应的配置：
```
environment:
  sdk: '>=3.10.0 <4.0.0'
```
可执行flutter --version查看当前Flutter版本，调整对应SDK范围。
重新同步项目
执行以下命令完成同步与构建：
```
flutter pub get
cd android && ./gradlew clean build --refresh-dependencies
cd .. && flutter run
```
也可在Android Studio中点击「Sync Project with Gradle Files」按钮重新同步。