Flutter Android插件Gradle构建正常但依赖未安装报错，求排查方案

核心排查方向 #

你的问题大概率是Gradle仓库配置缺失、依赖坐标错误或版本兼容性不匹配导致的，以下是具体排查步骤：

1. 检查Android端仓库配置 #

打开插件模块的android/build.gradle（注意是插件自身的配置文件，不是Flutter项目根目录的），确保repositories块包含必要的仓库源：

repositories {
    google()
    mavenCentral()
    // 若依赖来自JitPack，需额外添加：maven { url 'https://jitpack.io' }
}

同时检查项目根目录的settings.gradle，确认全局仓库配置正确：

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
    }
}

2. 验证依赖坐标正确性 #

核对插件android/build.gradle中dependencies块的依赖信息，确保groupId、artifactId、版本号完全准确，示例：

dependencies {
    // 正确的依赖写法示例
    implementation 'com.google.android.material:material:1.11.0'
}

如果是私有仓库依赖，还要确认仓库地址、账号密码配置无误。

3. 修复Gradle与Kotlin版本兼容性 #

你当前使用的Gradle 8.7和Kotlin 1.7.10存在版本不匹配：Gradle 8.x要求Kotlin版本至少1.8.0及以上。建议升级Kotlin版本，修改插件android/build.gradle：

plugins {
    id 'com.android.library'
    id 'kotlin-android'
    id 'dev.flutter.flutter-plugin-android'
}

kotlin {
    jvmToolchain(17) // 同时建议适配JDK 17，匹配Gradle 8.x要求
}

// 或直接指定Kotlin版本
plugins {
    id 'org.jetbrains.kotlin.android' version '1.8.20' apply false
}

4. 强制刷新依赖缓存 #

执行以下命令彻底清理并重新拉取依赖：

# 清理Flutter缓存
flutter clean
# 进入Android目录执行Gradle命令
cd android
./gradlew clean build --refresh-dependencies

Windows系统替换为gradlew.bat clean build --refresh-dependencies

5. 检查网络与镜像配置 #

国内环境建议配置阿里云镜像加速，在gradle.properties中添加：

mavenCentralUrl=https://maven.aliyun.com/repository/public
googleRepoUrl=https://maven.aliyun.com/repository/google

同时关闭无效代理，确保网络能正常访问Maven仓库。

6. 查看详细错误日志 #

执行命令获取完整依赖解析日志，精准定位问题：

./gradlew dependencies --info

日志会显示具体哪个依赖无法解析，以及失败原因（如404、权限问题等）。

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