Gradle中同时使用Nexus仓库与Netflix仓库的配置问题

可能的缺失配置及修复步骤 #

1. 补充Nexus仓库的认证配置 #

如果你的Nexus仓库需要身份验证，仅在settings.xml中配置server节点无法让Gradle自动识别，必须在仓库块中显式添加认证逻辑：

maven {
    name "server-id"
    url "https://repo.******.com/repository/***"
    credentials {
        // 优先从gradle.properties读取，其次取环境变量
        username = project.findProperty('nexusUsername') ?: System.getenv('NEXUS_USERNAME')
        password = project.findProperty('nexusPassword') ?: System.getenv('NEXUS_PASSWORD')
    }
}

可以把敏感信息放在项目根目录的gradle.properties文件中（记得加入.gitignore避免提交）：

nexusUsername=你的Nexus用户名
nexusPassword=你的Nexus密码

2. 调整仓库搜索顺序 #

Gradle会按repositories块中的顺序依次搜索依赖，建议将内部Nexus仓库放在靠前位置，确保Gradle优先检查内部依赖：

repositories {
    mavenCentral()
    // 先搜索内部Nexus仓库
    maven {
        name "server-id"
        url "https://repo.******.com/repository/***"
        credentials {
            username = project.findProperty('nexusUsername')
            password = project.findProperty('nexusPassword')
        }
    }
    // 原有的Netflix仓库配置
    maven {
        url "https://artifactory-oss.prod.netflix.net/artifactory/maven-oss-candidates"
    }
    exclusiveContent {
        forRepository {
            maven {
                url "https://artifactory-oss.prod.netflix.net/artifactory/required-jcenter-modules-backup"
            }
        }
        filter {
            includeGroupByRegex "com\\.github\\.vmg.*"
        }
    }
}

3. 确认Gradle与settings.xml的匹配关系 #

Gradle仅会读取settings.xml中与仓库name属性匹配的server认证信息，不会自动加载其中的仓库URL。所以必须在build.gradle中显式声明Nexus的URL，且name属性要和settings.xml里的server id完全一致。

4. 校验依赖坐标与仓库内容 #

• 核对内部依赖的groupId、artifactId、version是否与Nexus上的记录完全一致，避免拼写错误。
• 确认Nexus仓库中确实存在该依赖的对应版本，且上传到了正确的仓库路径。

5. 刷新Gradle缓存 #

Gradle可能缓存了旧的依赖搜索结果，执行以下命令清除缓存后重新构建：

./gradlew clean build --refresh-dependencies

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