配置Gradle仅为Sonatype Nexus 3仓库启用KeyStore/TrustStore

你遇到的核心问题是全局设置了JVM级别的SSL TrustStore，导致所有仓库（包括Maven Central）都强制使用自定义的keystore，而该keystore中没有Maven Central的CA证书，因此拉取依赖失败。下面是针对性的解决方案：

步骤1：移除全局SSL系统属性 #

先删掉gradle.properties中的全局SSL配置，避免影响所有仓库：

# 移除这两行全局配置
# systemProp.javax.net.ssl.trustStore=nexus/keystore.jks
# systemProp.javax.net.ssl.trustStorePassword=<mypw>

保留用户名密码和TrustStore密码（建议统一放在配置文件管理）：

MyNexusUsername=<user>
MyNexusPassword=<pwd>
MyNexusTrustStorePassword=<mypw>

步骤2：为私有Nexus仓库单独配置SSL上下文 #

在build.gradle中，通过自定义SSLContext的方式，仅让私有Nexus仓库使用你的keystore，Maven Central保持默认系统SSL配置：

// 定义创建自定义SSL上下文的方法
def createNexusSslContext() {
    def trustStorePath = "nexus/keystore.jks" // 相对于项目根目录的路径，按需调整
    def trustStorePassword = project.MyNexusTrustStorePassword

    // 加载自定义TrustStore
    KeyStore trustStore = KeyStore.getInstance("JKS")
    trustStore.load(new FileInputStream(file(trustStorePath)), trustStorePassword.toCharArray())

    // 初始化TrustManagerFactory
    TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm())
    tmf.init(trustStore)

    // 创建并返回SSL上下文
    SSLContext sslContext = SSLContext.getInstance("TLS")
    sslContext.init(null, tmf.getTrustManagers(), null)
    return sslContext
}

repositories {
    // Maven Central 使用系统默认SSL配置（包含主流CA证书）
    mavenCentral()

    // 私有Nexus仓库 应用自定义SSL上下文
    maven {
        name = 'MyNexus'
        credentials(PasswordCredentials) {
            username = project.MyNexusUsername
            password = project.MyNexusPassword
        }
        url = uri('https://myurl/repository/repo-name/')
        // 仅当前仓库使用自定义SSL验证规则
        sslContext = createNexusSslContext()
    }
}

原理说明 #

这种方式通过Gradle提供的sslContext配置项，为单个仓库单独指定SSL验证规则，而非修改全局JVM参数。Maven Central会自动使用系统默认的TrustStore，因此能正常拉取依赖；私有Nexus仓库则使用你自定义的keystore完成SSL验证，两者互不干扰。

注意事项 #

• 确保trustStorePath指向的keystore文件路径正确，可使用绝对路径或相对于项目根目录的相对路径
• 如果keystore格式不是JKS（比如PKCS12），需要修改KeyStore.getInstance()的参数为对应格式（如"PKCS12"）

内容的提问来源于stack exchange，提问作者Mehrer Compression GmbH - IT