如何让引用aar中不存在的类/方法时Android编译失败？

问题描述 #

在Android开发中，引用本地源码中不存在的类或方法时，编译阶段会直接报错失败；但如果引用的是AAR文件中不存在的类或方法，编译可以正常通过，只有在运行时才会抛出java.lang.NoSuchMethodError或类似异常导致崩溃。如何配置才能让这类场景在编译阶段就直接失败？

解决方案 #

可以通过以下几种方式实现编译期的严格检测：

1. 配置Android Lint规则强制检测缺失符号 #

在模块的build.gradle（或build.gradle.kts）中配置Lint，将缺失类/方法的检测结果升级为错误，强制编译终止：

android {
    lintOptions {
        checkAllWarnings true
        warningsAsErrors true
        // 明确指定检测缺失类、缺失方法的规则
        check 'MissingClass', 'MissingMethod'
    }
}

若使用KTS语法：

android {
    lintOptions {
        checkAllWarnings = true
        warningsAsErrors = true
        check("MissingClass", "MissingMethod")
    }
}

该配置会让Lint在编译阶段扫描所有代码引用，只要发现AAR中不存在的类或方法，就直接抛出错误终止编译流程。

2. 开启R8的严格模式（适用于混淆构建变体） #

如果项目使用R8进行代码混淆与优化，可通过ProGuard规则将未解析的符号问题升级为错误：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            // 引入自定义严格规则文件
            proguardFile file('strict-proguard-rules.pro')
        }
    }
}

在strict-proguard-rules.pro中添加：

-dontwarn
-errorprone

-dontwarn会禁用默认的未解析符号忽略逻辑，-errorprone会将所有未找到的符号问题转为错误，直接终止编译。

3. 集成静态代码分析工具（如SpotBugs） #

通过SpotBugs这类静态分析工具，在编译阶段扫描代码中引用的无效符号：
在模块build.gradle中添加依赖与配置：

plugins {
    id 'com.android.application'
    id 'com.github.spotbugs' version '5.0.13'
}

spotbugs {
    ignoreFailures = false // 检测到问题时直接终止编译
    reportLevel = 'high' // 仅报告高优先级问题，可按需调整
}

tasks.withType(com.github.spotbugs.snom.SpotBugsTask) {
    reports {
        xml.required = false
        html.required = true
    }
}

执行./gradlew spotbugsDebug或./gradlew spotbugsRelease即可触发检测，配置ignoreFailures = false后，一旦发现AAR中不存在的类/方法引用，编译会直接失败。

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