exclude对files()无效，因本地JAR无坐标信息，Gradle仅作二进制文件处理；需用flatDir升维为坐标依赖或自定义Configuration隔离，再配合packagingOptions/shadowJar做运行时裁剪。
为什么exclude对files()写的本地JAR完全无效
因为files('libs/sdk.jar')根本不在Gradle的依赖图谱里。它没有group、name、version，Gradle只把它当二进制文件塞进classpath，不解析META-INF/MANIFEST.MF，也不看里面打包了哪些类或依赖。你写exclude group: 'org.slf4j'就像对一块硬盘喊话——它听不见。
常见错误现象：build.gradle里写了implementation files('xxx.jar') { exclude group: 'xxx' }，编译通过，但运行时报SLF4J: Class path contains multiple SLF4J bindings或NoClassDefFoundError。
- 不是语法写错，是抽象层级错了：排除操作只对“坐标化依赖”生效
-
transitive = false对files()也无效——它本来就没有transitive属性 - 用
jar -tf libs/xxx.jar | grep slf4j确认是否已把依赖类打进去了；如果看到org/slf4j/路径下的class，说明是fat jar，必须从二进制层面处理
用flatDir仓库把本地JAR“升维”成可排除的坐标依赖
这是最轻量、兼容性最强的方案，不需要改jar包，也不依赖AGP版本。核心是让Gradle“假装”这个jar来自Maven仓库，从而启用依赖解析和排除机制。
实操步骤：
- 在
build.gradle顶部声明仓库：repositories { flatDir { dirs 'libs' } } - 把原来的
implementation files('libs/sdk.jar')换成：implementation(name: 'sdk', ext: 'jar')
（注意：不用写group，name必须和jar文件名一致，不含扩展名） - 现在就能正常排除了：
implementation(name: 'sdk', ext: 'jar') { exclude group: 'org.slf4j' exclude group: 'ch.qos.logback' }
原理：FlatDir让Gradle为该jar生成一个虚拟坐标，触发依赖元数据构建流程，exclude才真正起作用。Android AGP 7.0+默认禁用flatDir，需额外加settings.gradle配置：
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
}
用自定义Configuration做编译期隔离
适合需要精细控制classpath、或多个模块共用同一组本地jar的场景。它绕过默认的implementation语义，自己建一条“不参与全局依赖仲裁”的路径。
关键点：
- 声明新配置：
configurations { localLibs { canBeResolved = true canBeConsumed = false } } - 用
files()挂载jar，但走这个配置：dependencies { localLibs files('libs/sdk.jar') } - 把类加到编译期classpath，但不参与运行时依赖传递：
sourceSets.main.compileClasspath += configurations.localLibs
- 此时若要排除jar里的冲突类，得靠
packagingOptions（Android）或shadowJar过滤（Java应用），而非exclude
优势：完全规避Gradle依赖解析，避免被resolutionStrategy误干预；缺点：无法享受依赖版本仲裁，需手动确保jar之间无冲突。
运行时类排除：当编译期排除不生效时的兜底手段
某些fat jar（比如打包了slf4j-api和logback-classic的SDK）即使升维后exclude仍可能漏掉部分类——因为它们已被重命名或内联进主jar。这时得在打包阶段做二进制裁剪。
Android项目可用packagingOptions：
android {
packagingOptions {
exclude 'org/slf4j/**'
exclude 'ch/qos/logback/**'
exclude 'META-INF/*.kotlin_module'
}
}
Java应用（如Spring Boot）推荐用shadowJar插件：
shadowJar {
dependencies {
exclude(dependency('org.slf4j:.*'))
exclude(dependency('ch.qos.logback:.*'))
}
}
注意：exclude路径区分大小写；META-INF下签名文件（如.SF、.DSA）不能删，否则APK校验失败；**通配符只匹配路径，不匹配jar内嵌jar。
最容易被忽略的一点：排除只是让类不出现在最终APK或fat jar里，但如果你的代码显式import了被排除的类（比如import org.slf4j.Logger），编译会直接失败——必须同步改代码，或用桥接层封装。
