多模块项目执行gradlew test时BuildConfig.BASE_API_URL引用报错求助

问题原因 #

.\gradlew test命令默认会执行所有构建变体的单元测试（比如debugUnitTest、releaseUnitTest、debugTestingUnitTest等）。如果你的某个构建类型（比如release）没有配置BASE_API_URL这个buildConfigField，当执行该变体的单元测试时，就会出现Unresolved reference: BASE_API_URL的错误——哪怕你平时只跑debug变体的测试，test命令也会遍历所有变体。

另外，新版Android Gradle Plugin（AGP）默认可能关闭了BuildConfig生成，也会导致测试变体无法生成对应的BuildConfig类。

解决步骤 #

1. 为所有构建类型配置BuildConfig字段 #

检查network模块的build.gradle，确保所有buildTypes节点下都添加了BASE_API_URL的配置，比如补充release类型：

buildTypes {
    debug {
        minifyEnabled = false
        debuggable = true
        buildConfigField "String", "BASE_API_URL", "\"https://gateway.marvel.com:443\""
        buildConfigField "String", "PUBLIC_API_KEY", "\"c3103d371d2sddd625sdsd4c9f12f0qq312dcbd5102165\""
        buildConfigField "String", "PRIVATE_API_KEY", "\"26121b5a8849ac897ace8d33a66a6f731ff7a93a\""
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }

    debugTesting {
        minifyEnabled = false
        debuggable = true
        buildConfigField "String", "BASE_API_URL", "\"http://localhost:8080\""
        buildConfigField "String", "PUBLIC_API_KEY", "\"abcde\""
        buildConfigField "String", "PRIVATE_API_KEY", "\"abcd\""
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }

    release {
        minifyEnabled = true
        buildConfigField "String", "BASE_API_URL", "\"https://gateway.marvel.com:443\""
        // 补充release环境的其他密钥配置
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

如果不想每个buildTypes重复配置，可把公共字段放到defaultConfig里，需要覆盖的构建类型再单独定义：

defaultConfig {
    // 其他配置...
    buildConfigField "String", "BASE_API_URL", "\"https://gateway.marvel.com:443\""
}

buildTypes {
    debug {
        // 保持原有配置，可选择覆盖默认值
    }
    // 其他构建类型无需修改的话，不用重复定义字段
}

2. 只执行指定变体的单元测试 #

如果只想跑debug变体的单元测试，不用遍历所有变体，直接指定具体测试任务即可：

.\gradlew :network:debugUnitTest

这样只会处理debug变体的BuildConfig，避免触发未配置字段的变体测试。

3. 确保BuildConfig生成已开启 #

使用AGP 7.0+时，默认可能关闭了BuildConfig生成，需在模块的build.gradle中手动开启：

android {
    // 其他配置...
    buildFeatures {
        buildConfig = true
    }
}

4. 检查测试代码的BuildConfig引用 #

如果单元测试代码中也用到了BuildConfig，要确保引用的是network模块自身的BuildConfig（比如com.your.package.network.BuildConfig），避免包名引用错误导致的字段找不到问题。

内容的提问来源于stack exchange，提问作者Oscar Ivan