克隆Mapbox Android地图仓库构建提示找不到kotlin插件问题求助

错误根因 #

Gradle无法匹配到kotlin插件的有效版本与下载源，常见触发原因如下：

• 未使用项目配套的Gradle Wrapper构建，本地全局Gradle版本与项目要求版本不兼容
• 项目根目录settings.gradle的插件仓库配置缺失，或本地网络无法访问公共插件仓库
• 本地全局Gradle配置覆盖了项目的插件仓库规则
• 子模块未继承到根目录统一声明的Kotlin插件版本

分步解决步骤 #

1. 优先使用项目自带的Gradle Wrapper构建，不要使用本地全局Gradle
   进入项目根目录，执行命令构建：

   # Mac/Linux系统执行
   ./gradlew assembleDebug
   # Windows系统执行
   gradlew.bat assembleDebug
   

   若需要在Android Studio中构建，打开设置→Build, Execution, Deployment→Build Tools→Gradle，勾选「Use Gradle from: 'wrapper' task in Gradle build script」。

2. 检查根目录settings.gradle的pluginManagement配置
   确保配置块包含以下仓库，可额外添加国内镜像源提升拉取成功率：

   pluginManagement {
       repositories {
           // 可选添加阿里云镜像，替换官方源
           // maven { url 'https://maven.aliyun.com/repository/gradle-plugin' }
           gradlePluginPortal()
           google()
           mavenCentral()
       }
   }
   

3. 补全子模块Kotlin插件声明
   若上述步骤无效，直接修改mapbox-lint/build.gradle中的插件声明，替换为带版本的完整ID（版本号需和项目根目录声明的Kotlin版本保持一致，可从根目录依赖配置中查询）：

   // 替换原来的 id 'kotlin'
   id 'org.jetbrains.kotlin.jvm' version '1.8.22'
   

4. 检查本地全局Gradle配置
   进入用户目录下的.gradle文件夹，查看是否存在init.gradle或init.gradle.kts文件，若存在需确保文件中的全局仓库配置没有屏蔽google、gradlePluginPortal等官方源。

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