禁用单个依赖的传递性需在声明闭包中设transitive = false（Groovy）或isTransitive = false（Kotlin），files()引入的本地jar不支持该配置，因其无坐标和依赖元数据。
用 transitive = false 禁用单个依赖的传递性
Gradle 默认会把直接依赖所声明的所有间接依赖（即传递依赖）一并拉进来。如果你确认某个依赖本身已完整，或项目里已有替代实现（比如自己提供了 slf4j-api），就可以关掉它的传递引入，避免冲突或冗余。
关键点是：必须在依赖声明的闭包中设置 transitive = false，不能写在外部或用 exclude 替代。
-
implementation('com.facebook.fresco:fresco:2.10.0') { transitive = false }—— 正确写法，transitive是 Groovy DSL 中的布尔属性名 -
implementation('com.facebook.fresco:fresco:2.10.0', { transitive = false })—— 旧版写法（AGP 7.0 前常见），仍可用但不推荐 - 不要写成
exclude group: 'com.facebook'，那针对的是子模块，不是禁用整个传递链 - 禁用后，
gradle dependencies输出里该依赖节点下将不再有|+或|\展开的子依赖树
isTransitive = false 在 Kotlin DSL 中怎么写
Kotlin DSL 不支持 transitive = false 这种旧式 Groovy 写法，它要求显式调用 API 方法。你得用 isTransitive = false（注意是属性赋值，不是函数调用）。
-
implementation("org.springframework.boot:spring-boot-starter-web:3.2.0") { isTransitive = false }—— Kotlin DSL 唯一有效写法 - 写成
transitive(false)或setTransitive(false)都会编译失败 - 如果混用 Groovy 和 Kotlin 脚本（如
build.gradle.kts+gradle.properties），确保没有跨脚本覆盖配置逻辑 - 禁用后若出现
NoClassDefFoundError，说明你删掉了运行必需的类——这不是配置错，而是你低估了该依赖的真实依赖面
为什么 files('xxx.jar') 上加 transitive = false 没用
因为 files() 引入的是纯文件路径，Gradle 根本不把它当“有依赖关系的模块”处理。它没有 pom.xml、不解析 META-INF/MANIFEST.MF 中的 Class-Path，更不会构建依赖图——所以 transitive、exclude、constraints 全部失效。
-
implementation files('libs/sdk-fat.jar') { transitive = false }—— 这行里的transitive = false实际被忽略，毫无效果 - 真正生效的只有：把 jar 放进本地 Maven 仓库、用
maven { url = uri("file://...") }声明、再以坐标形式引用 - 或者改用
configurations.compileClasspath.files手动过滤 classpath，但这只影响编译期，不解决运行时类重复问题 - 最稳妥的解法是源头治理：让提供方发一个不含内嵌依赖的 “thin jar”，或你自己用
jar --delete剥离不需要的 class（注意签名失效风险）
禁用传递依赖后，哪些问题最容易被忽略
关掉传递性不是终点，而是排查起点。很多团队在加了 transitive = false 后没出编译错误，就以为万事大吉，结果上线后报 NoSuchMethodError 或 LinkageError。
- Spring Boot 的 starter 依赖（如
spring-boot-starter-data-jpa）关掉传递后，HibernateException类可能直接找不到——因为hibernate-core没被拉进来 - Android 项目中禁用
androidx.appcompat:appcompat的传递依赖，会导致R.styleable相关资源解析失败，且错误堆栈不提示根本原因 - 某些库通过
ServiceLoader加载 SPI 实现（如java.sql.Driver），禁用传递后对应META-INF/services/文件缺失，运行时静默失败 - 建议每次禁用后都执行
./gradlew :app:dependencies --configuration runtimeClasspath，确认关键运行时依赖是否还在 classpath 上
