仅在测试中使用Kotlin Gradle插件，如何避免其成为传递依赖？

问题根源 #

org.jetbrains.kotlin.jvm插件默认会把Kotlin标准库（kotlin-stdlib、kotlin-stdlib-jdk7/8等）添加到implementation配置中——这个配置的依赖会自动传递给下游模块，哪怕你的业务代码全是Java编写，也会导致这些Kotlin依赖混入最终产物。

解决方法 #

方法一：禁用插件自动添加标准库依赖

在通用build.gradle中添加配置，关掉Kotlin插件自动引入标准库的行为，只在测试环节手动引入所需依赖：

plugins {
    id 'org.jetbrains.kotlin.jvm'
    id 'java' // 确保Java插件正常工作
}

kotlin {
    // 禁用自动添加Kotlin标准库依赖
    stdlib.defaultDependency = false
    jvm {
        withJava() // 让Kotlin插件与Java插件兼容
    }
}

dependencies {
    // 仅测试阶段引入Kotlin相关依赖
    testImplementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.6.10'
    testImplementation 'org.jetbrains.kotlin:kotlin-reflect:1.6.10'
    testImplementation 'org.jetbrains.kotlin:kotlin-test:1.6.10'
    testImplementation 'org.jetbrains.kotlin:kotlin-test-junit5:1.6.10'
}

配置完成后，Kotlin依赖只会出现在测试类路径中，不会进入implementation配置，自然不会被传递到下游模块。

方法二：仅在测试阶段应用Kotlin插件

如果业务模块完全不需要Kotlin编译支持（仅测试用Kotlin），可以移除全局的kotlin-jvm插件，改用测试专用插件：

1. 修改settings.gradle的插件管理：

pluginManagement {
    plugins {
        id 'org.jetbrains.kotlin.test' version '1.6.10'
        id 'org.jetbrains.kotlin.test.junit5' version '1.6.10'
    }
}

2. 修改通用build.gradle：

plugins {
    id 'java' // 核心用Java插件管理业务代码
    id 'org.jetbrains.kotlin.test'
    id 'org.jetbrains.kotlin.test.junit5'
}

dependencies {
    testImplementation 'org.jetbrains.kotlin:kotlin-stdlib-jdk8:1.6.10'
    testImplementation 'org.jetbrains.kotlin:kotlin-reflect:1.6.10'
}

这种方式下，Kotlin相关依赖完全和业务代码隔离，不会产生任何传递依赖问题。

方法三：排除传递依赖（应急方案）

如果前两种方法无法快速生效，可以在发布模块时手动排除Kotlin依赖，确保产物不包含这些依赖：

plugins {
    id 'maven-publish' // 以Maven发布为例
}

publishing {
    publications {
        mavenJava(MavenPublication) {
            from components.java
            // 把Kotlin依赖标记为provided，避免传递
            pom.withXml {
                def dependenciesNode = asNode().appendNode('dependencies')
                configurations.implementation.allDependencies.each { dep ->
                    if (dep.group == 'org.jetbrains.kotlin') {
                        def dependencyNode = dependenciesNode.appendNode('dependency')
                        dependencyNode.appendNode('groupId', dep.group)
                        dependencyNode.appendNode('artifactId', dep.name)
                        dependencyNode.appendNode('version', dep.version)
                        dependencyNode.appendNode('scope', 'provided')
                    }
                }
            }
        }
    }
}

注意：这是事后补救方案，不如前两种从根源解决彻底。

验证 #

执行./gradlew dependencies查看依赖树，确认org.jetbrains.kotlin相关依赖仅出现在testImplementation或测试类路径中，implementation配置下无这些依赖即可。

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