Flutter项目无法运行：gradle编译报错，请求解决方案

云上老周

2026-7-1

解决Flutter项目时隔数月运行出现的Gradle编译错误

错误原因分析

该问题源于时隔数月后，Flutter SDK、第三方依赖（如url_launcher_android）与本地Android Gradle插件/Gradle版本不兼容：

新版本依赖使用了旧版Gradle不支持的API（如buildFeatures方法）
缺少全局统一的compileSdkVersion配置，引发连锁错误

具体解决步骤

更新Flutter SDK到稳定版
打开终端执行：
```
flutter channel stable && flutter upgrade
```
更新依赖并清理缓存
进入项目根目录，依次执行：
```
flutter pub upgrade
flutter pub cache clean
flutter pub get
```
同步Android Gradle插件与Gradle版本
1. 打开项目android/build.gradle，修改Android Gradle插件版本（示例搭配Gradle 7.5）：
```
dependencies {
    classpath 'com.android.tools.build:gradle:7.4.2'
    // 保留其他原有依赖
}
```
2. 打开android/gradle/wrapper/gradle-wrapper.properties，修改Gradle版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-all.zip
```

配置全局compileSdkVersion
在android/build.gradle的subprojects块中添加统一配置，避免依赖库未指定版本的问题：

subprojects {
    afterEvaluate { project ->
        if (project.hasProperty('android')) {
            android {
                compileSdkVersion 33 // 可使用Flutter推荐的对应版本
                defaultConfig {
                    minSdkVersion 21 // 根据项目实际需求调整
                }
            }
        }
    }
}