如何使用Gradle排除aar依赖包中的指定.class文件

Gradle 没有提供和 exclude group: 完全对应的针对单个 .class 文件的依赖级排除语法，但可以通过「打包时过滤目标类 + 本地同名类覆盖」的方式实现需求，操作步骤如下：

方案1：使用 packagingOptions 直接排除（推荐，适配所有AGP版本） #

这是成本最低的实现方式，不需要额外引入插件：

1. 先确认你要排除的类在aar中的全路径，比如目标类是 com.xxx.sdk.BuggyClass，对应的class路径就是 com/xxx/sdk/BuggyClass.class
2. 在模块级的 build.gradle 中添加配置：

android {
    // 其他原有配置
    packagingOptions {
        // 排除aar中的目标class
        exclude "com/xxx/sdk/BuggyClass.class"
    }
}

如果用的是Kotlin DSL，配置如下：

android {
    // 其他原有配置
    packaging {
        resources.excludes.add("com/xxx/sdk/BuggyClass.class")
    }
}

3. 在你的项目src/main/java目录下，创建和目标类完全相同的包路径，新建同名的.java文件，写入修复后的代码即可。编译打包时构建工具会自动使用你本地的类替换原有aar中的类。

方案2：自定义转换逻辑（适用于复杂场景） #

如果你需要对多个类做批量处理、或者需要在编译期动态修改类内容，AGP 7.0+ 可以使用 Instrumentation Transform 实现类的拦截替换，AGP 7.0以下版本可以使用已废弃的 Transform API 实现，这类方案配置成本较高，普通单类替换场景不需要使用。

• 本地替换类的包名、类名、对外公开的方法签名必须和原类完全兼容，否则会出现运行时NoSuchMethodError、ClassCastException等异常
• 如果原类有混淆配置，需要确保你替换的类也同步适配对应的混淆规则，避免类名或者方法被混淆后无法匹配调用
• 升级依赖aar版本时，需要同步校验原类的接口是否有变更，避免替换类和新版本不兼容

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