gradle的configuration机制本质是依赖声明与解析的契约容器，通过自定义专用configuration并断开继承、禁用消费、限制传递依赖，实现精准的依赖隔离。
Gradle 的 Configuration 机制本质是依赖声明与解析的契约容器，不是“环境”本身，但可通过它精准定义一组独立的依赖边界——这正是实现专属依赖隔离的核心。
理解 Configuration 的本质角色
Configuration 是 Gradle 中用于声明、解析、消费依赖的逻辑分组。它不自动创建类路径或运行时环境，而是为依赖生命周期（声明 → 解析 → 使用）提供可配置的上下文。自定义隔离的关键在于：避免复用默认 Configuration（如 implementation 或 compileClasspath），而是新建专用 Configuration，并切断其与默认图谱的隐式继承关系。
定义专用 Configuration 并禁用继承
在 build.gradle（Groovy）或 build.gradle.kts（Kotlin）中显式创建，关键点是设 canBeResolved = true（允许解析）、canBeConsumed = false（不对外提供），并清除 extendsFrom：
- Groovy 示例：
configurations.create("myIsolatedDeps") {
canBeResolved = true
canBeConsumed = false
extendsFrom = [] // 彻底断开继承链
}
- Kotlin DSL 示例：
configurations.create("myIsolatedDeps") {
isCanBeResolved = true
isCanBeConsumed = false
extendsFrom.clear()
}
绑定依赖与控制解析范围
向该 Configuration 声明依赖后，需通过 ResolutionStrategy 或 resolutionRules 进一步收窄作用域：
- 只允许特定组织/模块（例如仅 com.example:utils）：
- 强制版本对齐（避免间接引入冲突版本）：
- 禁止传递依赖（设置 transitive = false）：
dependencies {
myIsolatedDeps("com.example:utils:1.2.0") {
transitive = false
}
}
configurations.myIsolatedDeps {
resolutionStrategy {
force "org.slf4j:slf4j-api:2.0.9"
failOnVersionConflict()
}
}
在代码或任务中安全使用该隔离集
不能直接将 Configuration 当 classpath 用，必须显式解析成文件集合再传入：
- 在自定义 Task 中获取已解析的 JAR 列表：
tasks.register("runWithIsolatedDeps", JavaExec) {
classpath = configurations.myIsolatedDeps
mainClass.set("com.example.MyTool")
}
- 在编译期注入（如 Annotation Processor）时，用 options.annotationProcessorPath 显式指定：
javaCompile {
options.annotationProcessorPath.setFrom(configurations.myIsolatedDeps)
}
这样，该 Configuration 中的依赖仅在明确指向它的上下文中生效，不会污染 compileClasspath 或 runtimeClasspath。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
