Gradle 8.0升级后@BindView编译报错：元素值需为常量表达式

核心原因 #

Gradle 8.0搭配Android Gradle Plugin 8.0后，默认对单元测试构建开启了R类非常量化处理——单元测试编译阶段，R.id不再是编译期常量，但@BindView注解要求传入的参数必须是常量表达式，因此触发报错。

具体解决步骤 #

• 方案1：强制单元测试R类保持常量
  在模块的build.gradle.kts（或Groovy版build.gradle）中添加配置，让单元测试编译时R.id恢复为常量：
  Kotlin DSL写法：

  android {
      testOptions {
          unitTests {
              isIncludeAndroidResources = true
              all {
                  it.extensions.configure<com.android.build.gradle.internal.testing.unitTest.JUnitOptions> {
                      isAllowNonLocalFinalFields = true
                  }
              }
          }
      }
  }
  

  Groovy写法：

  android {
      testOptions {
          unitTests {
              includeAndroidResources = true
              all {
                  it.extensions.getByType(com.android.build.gradle.internal.testing.unitTest.JUnitOptions).allowNonLocalFinalFields = true
              }
          }
      }
  }
  

• 方案2：迁移到官方ViewBinding（长期最优解）
  ButterKnife已停止维护，和新版Gradle/AGP兼容性越来越差，直接切换到官方ViewBinding彻底解决问题：

  1. 在模块build.gradle中开启ViewBinding：

     android {
         buildFeatures {
             viewBinding = true
         }
     }
     

  2. 替换@BindView代码，比如原来的：

     @BindView(R.id.screen_scan)
     TextView scanScreen;
     

     改成ViewBinding写法：

     private ActivityMainBinding binding;
     
     @Override
     protected void onCreate(Bundle savedInstanceState) {
         super.onCreate(savedInstanceState);
         binding = ActivityMainBinding.inflate(getLayoutInflater());
         setContentView(binding.getRoot());
         // 直接通过binding调用控件
         binding.screenScan.setText("测试内容");
     }
     

• 方案3：临时升级/调整ButterKnife依赖
  若暂时不想迁移，可尝试升级ButterKnife到最新稳定版（10.2.3），同时确保单元测试也引入注解处理器：

  dependencies {
      implementation 'com.jakewharton:butterknife:10.2.3'
      annotationProcessor 'com.jakewharton:butterknife-compiler:10.2.3'
      testAnnotationProcessor 'com.jakewharton:butterknife-compiler:10.2.3'
  }
  

  注意：此方案仅为临时过渡，后续Gradle版本更新可能再次出现兼容问题。

验证方式 #

修改配置后，本地先执行./gradlew testDebugUnitTest确认编译通过，再提交代码触发GitLab-CI流水线验证。

内容的提问来源于stack exchange，提问作者A. Silva