如何让通过buildSrc插件添加的测试依赖出现在Maven POM中？

要让buildSrc中定义的测试依赖出现在发布的POM文件里，核心是要把测试依赖关联到发布的-tests.jar对应的依赖配置中——Gradle默认不会将testImplementation/testRuntimeOnly这类测试配置的依赖自动加入发布的POM，因为这些配置默认只用于本地测试，不对外暴露。以下是两种可行方案：

方案一：使用官方java-test-fixtures插件（推荐） #

Gradle的java-test-fixtures插件专门用于管理和发布测试相关的代码与依赖，会自动处理POM中的依赖声明，无需手动修改XML。

1. 在buildSrc的插件中引入该插件，并调整依赖配置：

plugins {
    id 'java'
    id 'java-test-fixtures'
}

dependencies {
    // 将原testImplementation改为testFixturesImplementation
    testFixturesImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
    testFixturesImplementation 'ch.qos.logback:logback-classic:1.2.3'
    // 测试运行时依赖同理
    testFixturesRuntimeOnly 'org.junit.jupiter:junit-jupiter-engine:5.7.0'
}

2. 在项目的发布配置中，包含测试fixtures的组件或artifact：

publishing {
    publications {
        maven(MavenPublication) {
            from components.java
            // 发布测试fixtures的jar包（自动带-tests分类器）
            from components.testFixtures
        }
    }
}

这样发布后，POM中会自动将这些测试依赖标记为test scope，同时-tests.jar也会被正确发布。

方案二：手动修改Maven发布的POM内容 #

如果不想用java-test-fixtures插件，可以手动遍历测试配置的依赖，将其添加到POM的<dependencies>节点中。

1. 确保已正确配置testJar任务（用于生成-tests.jar）：

tasks.register('testJar', Jar) {
    from sourceSets.test.output
    archiveClassifier.set('tests')
}

2. 在发布配置中，添加测试依赖到POM：

publishing {
    publications {
        maven(MavenPublication) {
            from components.java
            // 将-tests.jar加入发布产物
            artifact tasks.testJar

            // 手动注入测试依赖到POM
            pom.withXml {
                def dependenciesNode = asNode().appendNode('dependencies')

                // 处理testImplementation依赖
                configurations.testImplementation.allDependencies.each { dep ->
                    def depNode = dependenciesNode.appendNode('dependency')
                    depNode.appendNode('groupId', dep.group)
                    depNode.appendNode('artifactId', dep.name)
                    depNode.appendNode('version', dep.version)
                    depNode.appendNode('scope', 'test')
                }

                // 处理testRuntimeOnly依赖
                configurations.testRuntimeOnly.allDependencies.each { dep ->
                    def depNode = dependenciesNode.appendNode('dependency')
                    depNode.appendNode('groupId', dep.group)
                    depNode.appendNode('artifactId', dep.name)
                    depNode.appendNode('version', dep.version)
                    depNode.appendNode('scope', 'test')
                }
            }
        }
    }
}

注意点 #

你之前配置的versionMapping只负责控制依赖版本的解析来源，不会影响哪些依赖被包含到POM中，所以要解决问题不需要依赖这个配置。

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