Android多模块依赖命令行编译报cannot find symbol BuildConfig问题

核心原因 #

这个问题90%以上的概率是Android Gradle Plugin(AGP) 7.0+版本默认行为变更+Android Studio缓存机制共同导致的：

1. AGP 7.0及以上版本默认关闭了模块的BuildConfig生成能力，需要显式配置开启
2. Android Studio的索引缓存会保留历史生成的BuildConfig文件，所以IDE内不会提示报错、也能正常安装运行，但命令行全编译会清理增量缓存，没有显式配置的情况下B模块不会生成BuildConfig，直接导致编译报错
3. A模块无报错是因为A自身已开启BuildConfig生成，引用的是自身的BuildConfig或者IDE缓存的B模块BuildConfig，不会触发编译错误

可按优先级依次排查解决： #

• 显式开启B模块的BuildConfig生成能力
  在B模块的build.gradle（Groovy）或build.gradle.kts（Kotlin）的android配置块中添加全局配置：

  android {
      // 其他配置省略
      buildFeatures {
          // 显式开启BuildConfig生成，AGP 7.0+默认关闭
          buildConfig true
          // Kotlin DSL写法为 buildConfig = true
      }
  }
  

  注意不要将该配置只写在特定buildType或productFlavor下，除非你明确只需要特定变种生成BuildConfig。
• 对齐命令行编译变种与Android Studio运行变种
  检查你命令行执行的编译任务对应的变种（比如assembleRelease对应release变种），确认你没有仅在Android Studio默认运行的debug变种下开启BuildConfig生成，导致release编译时没有生成对应文件。
• 检查自定义Gradle任务的执行顺序
  如果项目中有自定义Gradle任务，可在编译命令后加--dry-run参数查看任务执行顺序，确认B模块的generate<变种名>BuildConfig任务执行在compile<变种名>JavaWithJavac/compile<变种名>Kotlin任务之前，如果顺序异常，需要给编译任务添加对BuildConfig生成任务的依赖：

  // 示例：给B模块的debug Java编译任务添加依赖
  afterEvaluate {
      compileDebugJavaWithJavac.dependsOn generateDebugBuildConfig
  }
  

• 清理缓存重新编译
  配置修改后执行全量清理编译，排除缓存干扰：

  ./gradlew clean assemble<你的目标变种> --no-build-cache
  

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