Gradle替换compile为implementation后POM依赖scope异常变为runtime的解决方法

我有一个简单的Gradle项目（Groovy DSL），配置如下：

plugins {
    id 'application'
    id 'maven-publish'
}

repositories { mavenCentral() }

dependencies {
     compile 'com.google.guava:guava:31.1-jre'      // 'compile' 已废弃
}

publishing {
    publications {
        maven(MavenPublication) {
            groupId = 'de.mabe'; artifactId = 'project1'; version = '1.0'
            from components.java
        }
    }
}

执行gradle publishToMavenLocal后，生成的POM文件中依赖scope为compile，符合预期：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>31.1-jre</version>
    <scope>compile</scope>             <!-- 这个scope很重要 -->
</dependency>

将依赖配置中的compile替换为implementation后：

implementation 'com.google.guava:guava:31.1-jre'

POM文件中的依赖scope意外变为runtime：

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>31.1-jre</version>
    <scope>runtime</scope>             <!-- 期望是compile？！ -->
</dependency>

如何操作才能恢复原来的POM文件配置？

方法一：使用api配置（推荐） #

Gradle的implementation配置设计为内部依赖，不会暴露给依赖当前项目的其他模块，因此发布到Maven POM时默认映射为runtime scope。若要对应Maven的compile scope，需使用api配置——但该配置属于java-library插件，因此需要先引入该插件：

修改后的完整配置：

plugins {
    id 'application'
    id 'maven-publish'
    id 'java-library' // 添加java-library插件以启用api配置
}

repositories { mavenCentral() }

dependencies {
     api 'com.google.guava:guava:31.1-jre' // 用api替代implementation
}

publishing {
    publications {
        maven(MavenPublication) {
            groupId = 'de.mabe'; artifactId = 'project1'; version = '1.0'
            from components.java
        }
    }
}

api配置的作用与废弃的compile一致，会将依赖暴露给上层项目，发布后POM中的scope会自动设为compile。

方法二：手动修改POM的依赖scope #

若不想引入java-library插件，可通过pom.withXml手动调整依赖的scope：

修改publishing块如下：

publishing {
    publications {
        maven(MavenPublication) {
            groupId = 'de.mabe'; artifactId = 'project1'; version = '1.0'
            from components.java

            // 手动生成依赖节点并指定scope为compile
            pom.withXml {
                // 清除默认生成的依赖节点（避免重复）
                asNode().remove(asNode().dependencies)
                def dependenciesNode = asNode().appendNode('dependencies')
                
                // 处理implementation依赖
                configurations.implementation.allDependencies.each { dep ->
                    def dependencyNode = dependenciesNode.appendNode('dependency')
                    dependencyNode.appendNode('groupId', dep.group)
                    dependencyNode.appendNode('artifactId', dep.name)
                    dependencyNode.appendNode('version', dep.version)
                    dependencyNode.appendNode('scope', 'compile')
                }
                
                // 若有其他需要保留的依赖（如compileOnly），可在此添加处理逻辑
            }
        }
    }
}

此方法直接干预POM的生成过程，强制将implementation依赖的scope设为compile。

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