企业代理环境下Gradle引入Credentials插件遇循环依赖及插件找不到

1. 先解决插件仓库的访问问题 #

由于防火墙限制，Gradle无法从默认插件仓库拉取目标插件，得先让它从企业Nexus获取插件。修改项目根目录的settings.gradle.kts，添加插件仓库配置：

pluginManagement {
    repositories {
        maven {
            name = "nexus-plugin-repo"
            url = uri("你的企业Nexus插件仓库地址")
            // 优先用环境变量或全局gradle.properties存凭证，避免硬编码
            credentials {
                username = System.getenv("NEXUS_USER") ?: findProperty("nexusUser") as String? ?: ""
                password = System.getenv("NEXUS_PWD") ?: findProperty("nexusPwd") as String? ?: ""
            }
        }
        // 可选：保留官方仓库作为备用，但防火墙环境下大概率没用
        gradlePluginPortal()
    }
}

你可以在终端临时设置环境变量，或者在~/.gradle/gradle.properties（全局，不会被提交到版本库）中添加：

nexusUser=你的Nexus用户名
nexusPwd=你的Nexus密码

2. 调整build.gradle.kts的凭证逻辑 #

现在重新执行./gradlew :app:tasks --all，应该能正常拉取nu.studer.credentials插件了。之后调整项目构建脚本的凭证加载逻辑：

import nu.studer.gradle.credentials.domain.CredentialsContainer

plugins {
    application
    id("nu.studer.credentials") version "3.0"
}

val credentials: CredentialsContainer by project.extra
// 优先从插件的安全存储读取凭证，读不到则 fallback 到环境变量或配置
val repositoryUsername = credentials.getProperty("username") ?: System.getenv("NEXUS_USER") ?: findProperty("nexusUser") as String?
val repositoryPassword = credentials.getProperty("password") ?: System.getenv("NEXUS_PWD") ?: findProperty("nexusPwd") as String?

repositories {
    mavenCentral()
    maven {
        name = "nexus"
        url = uri("nexus-package-url")
        credentials {
            username = repositoryUsername
            password = repositoryPassword
        }
    }
}

3. 用插件管理凭证（更安全的可选操作） #

插件加载成功后，执行以下命令将凭证存入插件的安全存储，后续就无需依赖环境变量或配置文件：

./gradlew credentialsSetProperty -PpropertyName=username -PpropertyValue=你的Nexus用户名
./gradlew credentialsSetProperty -PpropertyName=password -PpropertyValue=你的Nexus密码

完成后可以去掉build.gradle.kts里的fallback逻辑，直接使用插件管理的凭证。

关键注意点 #

• settings阶段（插件仓库配置环节）无法使用nu.studer.credentials插件，因此这部分的凭证只能通过环境变量、全局gradle.properties或系统属性配置，不存在循环依赖的解法——逻辑上插件还没加载，没法用它的功能。
• 绝对不要把包含明文密码的配置文件提交到版本控制系统，~/.gradle/gradle.properties是全局配置，不会被纳入项目提交，是更安全的选择。

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