Gradle无法解析含变量版本的传递依赖问题

环境与配置 #

• Gradle版本：4.10.2
• 项目build.gradle依赖配置：

dependencies {
    compile("com.rhuldip.artifactId:com.rhuldip.mainDependency:1.0.0-SNAPSHOT")
}

Maven仓库文件情况 #

目标依赖在仓库中的路径为REPO_URL/com/rhuldip/artifactId/com.rhuldip.mainDependency/1.0.0-SNAPSHOT，包含以下文件：

• maven-metadata.XML
• com.rhuldip.mainDependency-1.0.0.pom
• com.rhuldip.mainDependency-1.0.0.jar

依赖POM的关键配置 #

com.rhuldip.mainDependency-1.0.0.pom中使用了变量配置传递依赖：

<properties>
    <myapp.version>${revision}</myapp.version>
</properties>
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.rhuldip.myapp</groupId>
            <artifactId>transitiveDependeny</artifactId>
            <version>${myapp.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

报错信息 #

构建时出现如下解析错误：

01:08:40    > Could not resolve com.rhuldip.artifactId:com.rhuldip.mainDependency:1.0.0-SNAPSHOT.
01:08:40       > Could not parse POM REPO-URL/com/rhuldip/artifactId/com.rhuldip.mainDependency/1.0.0-SNAPSHOT/com.rhuldip.mainDependency-1.0.0-SNAPSHOT.pom
01:08:40          > Could not find com.rhuldip.myapp:transitiveDependeny:${revision}.

已尝试的无效操作 #

在build.gradle中通过ext定义revision变量，问题未解决：

ext {
    revision: '1.1.0-SNAPSHOT'
}

可行解决方案 #

方案1：修复依赖的POM发布流程 #

如果能修改依赖的构建配置，确保Maven在发布到仓库时完成${revision}变量的插值，生成包含具体版本号的POM文件。这是最优解，因为Maven变量本应在发布阶段就替换为实际值，而非留到依赖解析阶段。

方案2：Gradle中自定义POM变量替换 #

针对Gradle 4.10.2，可通过配置仓库的mavenPomXmlTransformer来手动替换POM中的变量：

repositories {
    maven {
        url "REPO_URL"
        // 自定义POM转换逻辑
        mavenPomXmlTransformer { xml ->
            // 替换properties中的myapp.version变量
            xml.replaceNode('//properties/myapp.version') {
                'myapp.version'('1.1.0-SNAPSHOT')
            }
            // 替换dependencyManagement中的传递依赖版本
            xml.replaceNode('//dependencyManagement/dependencies/dependency[artifactId="transitiveDependeny"]/version') {
                version('1.1.0-SNAPSHOT')
            }
        }
    }
}

方案3：本地显式声明传递依赖版本 #

在项目的build.gradle中直接导入传递依赖的BOM，覆盖依赖POM中的变量引用：

dependencyManagement {
    imports {
        mavenBom "com.rhuldip.myapp:transitiveDependeny:1.1.0-SNAPSHOT"
    }
}

dependencies {
    compile("com.rhuldip.artifactId:com.rhuldip.mainDependency:1.0.0-SNAPSHOT")
}

这种方式会让Gradle优先使用本地声明的版本，跳过对依赖POM中变量的解析。

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