如何在Gradle项目中定义POM属性？含${qualifier}依赖无法解析

问题本质 #

公司内部Maven项目的pom.xml存在不规范定义，依赖版本中使用了未正确传递的${qualifier}属性，Gradle默认不会自动识别并替换这类Maven占位符，所以直接在gradle.properties配置qualifier=RELEASE或简单在build.gradle中定义属性不会生效。

可行解决方案 #

方案1：通过依赖解析策略全局替换占位符

在build.gradle中添加resolutionStrategy，遍历所有依赖并替换版本中的${qualifier}：

configurations.all {
    resolutionStrategy.eachDependency { details ->
        // 检查依赖版本是否包含${qualifier}占位符
        if (details.requested.version?.contains('${qualifier}')) {
            // 从gradle.properties读取qualifier值，默认用RELEASE
            def targetQualifier = project.findProperty('qualifier') ?: 'RELEASE'
            // 替换版本中的占位符
            def fixedVersion = details.requested.version.replace('${qualifier}', targetQualifier)
            details.useVersion fixedVersion
        }
    }
}

dependencies {
    // 保持原依赖声明不变
    implementation 'com.yourcompany:your-internal-artifact:1.2.${qualifier}'
}

方案2：直接在依赖声明中替换版本

如果涉及的依赖不多，可以直接在依赖声明时拼接版本：

// 优先读取gradle.properties中的qualifier，无则用默认值
def qualifier = project.findProperty('qualifier') ?: 'RELEASE'

dependencies {
    // 直接拼接版本字符串
    implementation "com.yourcompany:your-internal-artifact:1.2.${qualifier}"
}

关键提示 #

• 确保gradle.properties中的配置格式正确：qualifier=RELEASE（不要有多余空格）
• 如果是私有仓库中的pom本身定义了${qualifier}作为项目属性但未正确发布，上述两种方案都是在Gradle侧主动处理占位符，比依赖pom属性传递更可靠

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