更换Gradle插件基础构件源：从Maven中央仓库切换至私有Artifactory或本地路径

问题原因 #

你通过plugins块的id()方式引入插件时，Gradle会优先从插件专属仓库（而非项目依赖仓库或buildscript仓库）查找插件构件，因此仅配置buildscript.repositories无法生效。

具体配置方案 #

1. 配置插件解析仓库（针对plugins DSL） #

在项目根目录的settings.gradle（或settings.gradle.kts）中添加插件仓库配置，指定私有Artifactory地址或本地路径：

Groovy DSL（settings.gradle）

pluginManagement {
    repositories {
        // 私有Artifactory仓库配置
        maven {
            url = uri("你的私有Artifactory仓库URL")
            // 仓库需认证时添加以下配置
            credentials {
                username = "你的仓库用户名"
                password = "你的仓库密码/访问令牌"
            }
        }
        // 本地Maven仓库路径（存放已下载pom的目录）
        maven {
            url = uri("file:///本地仓库绝对路径/比如/Users/xxx/.m2/repository")
        }
        // 可选：保留中央仓库作为 fallback
        // mavenCentral()
    }
}

Kotlin DSL（settings.gradle.kts）

pluginManagement {
    repositories {
        maven {
            url = uri("你的私有Artifactory仓库URL")
            credentials {
                username = "你的仓库用户名"
                password = "你的仓库密码/访问令牌"
            }
        }
        maven {
            url = uri("file:///本地仓库绝对路径/比如/Users/xxx/.m2/repository")
        }
        // mavenCentral() // 可选
    }
}

2. 同步配置项目依赖仓库（若项目自身依赖也需从指定仓库获取） #

在build.gradle中补充项目依赖的仓库配置：

repositories {
    maven {
        url = uri("你的私有Artifactory仓库URL")
        credentials {
            username = "你的仓库用户名"
            password = "你的仓库密码/访问令牌"
        }
    }
    maven {
        url = uri("file:///本地仓库绝对路径/比如/Users/xxx/.m2/repository")
    }
    // mavenCentral() // 可选
}

3. 验证配置 #

执行以下命令强制刷新依赖，确认构件从指定仓库拉取：

gradle build --refresh-dependencies

关键说明 #

• pluginManagement是Gradle专门用于配置插件解析逻辑的块，必须放在settings.gradle中，作用于整个项目的插件查找流程。
• 本地路径需使用正确URI格式：Windows系统用file:///C:/xxx/xxx，Linux/macOS用file:///xxx/xxx。
• 私有仓库若开启权限验证，必须添加credentials配置，否则会出现权限不足的拉取错误。

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