Android Data Binding编译报错：Failed to parse compiler options

问题背景 #

使用Kotlin开发Android应用的Fragment视图，已在build.gradle中启用Data Binding和View Binding，视图仅包含绑定到Observable类的TextView，代码逻辑无明显问题，但编译时抛出以下错误：

java.lang.RuntimeException: Failed to parse data binding compiler options. Params:

已尝试更新依赖库和Gradle版本，问题仍未解决，附上相关代码及堆栈信息，寻求问题原因及解决办法。

相关代码 #

1. 布局文件（fragment_sample.xml） #

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <data>
        <variable
            name="user"
            type="com.example.myapp.UserViewModel" />
    </data>

    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:gravity="center"
        android:orientation="vertical">

        <TextView
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@{user.name}"
            android:textSize="20sp" />
    </LinearLayout>
</layout>

2. Observable类（UserViewModel.kt） #

import androidx.databinding.BaseObservable
import androidx.databinding.Bindable
import com.example.myapp.BR

class UserViewModel : BaseObservable() {
    @get:Bindable
    var name: String = "Test User"
        set(value) {
            field = value
            notifyPropertyChanged(BR.name)
        }
}

3. Fragment代码（SampleFragment.kt） #

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import com.example.myapp.databinding.FragmentSampleBinding

class SampleFragment : Fragment() {
    private lateinit var binding: FragmentSampleBinding
    private val userViewModel = UserViewModel()

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View {
        binding = FragmentSampleBinding.inflate(inflater, container, false)
        binding.user = userViewModel
        return binding.root
    }
}

4. 模块级build.gradle配置 #

plugins {
    id 'com.android.application'
    id 'org.jetbrains.kotlin.android'
}

android {
    namespace 'com.example.myapp'
    compileSdk 33

    defaultConfig {
        applicationId "com.example.myapp"
        minSdk 24
        targetSdk 33
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = '1.8'
    }
    buildFeatures {
        dataBinding true
        viewBinding true
    }
}

dependencies {
    implementation 'androidx.core:core-ktx:1.9.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.9.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
    testImplementation 'junit:junit:4.13.2'
    androidTestImplementation 'androidx.test.ext:junit:1.1.5'
    androidTestImplementation 'androidx.test.espresso:espresso-core:3.5.1'
}

5. 完整堆栈信息 #

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':app:compileDebugJavaWithJavac'.
> java.lang.RuntimeException: Failed to parse data binding compiler options. Params:

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 2s

问题原因及解决办法 #

1. 检查Data Binding配置语法 #

• 原因：build.gradle中Data Binding的配置存在语法错误，或混合了新旧版本的配置写法。
• 解决：确保使用与当前AGP版本匹配的配置语法。AGP 4.0及以上推荐使用buildFeatures块：

  android {
      buildFeatures {
          dataBinding true
          viewBinding true
      }
  }
  

  若使用AGP 4.0以下版本，需使用旧写法：

  android {
      dataBinding {
          enabled = true
      }
      viewBinding {
          enabled = true
      }
  }
  

  避免同时混用两种写法，且配置项后不要添加多余的空格或符号。

2. 清理gradle.properties中的无效配置 #

• 原因：gradle.properties文件中存在空值或错误的Data Binding编译参数，比如android.databinding.compilerOptions=这类空配置项。
• 解决：打开项目根目录下的gradle.properties，查找并删除所有与android.databinding相关的无效配置项。

3. 确保AGP与Gradle版本兼容 #

• 原因：Android Gradle插件（AGP）与Gradle版本不匹配，导致Data Binding编译器无法正常工作。
• 解决：根据AGP版本选择对应兼容的Gradle版本，参考官方匹配规则：
  • AGP 7.4.x → Gradle 7.5+
  • AGP 8.0.x → Gradle 8.0+
  • AGP 8.1.x → Gradle 8.1+
    调整项目级build.gradle中的AGP版本：

  dependencies {
      classpath 'com.android.tools.build:gradle:7.4.2'
      classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:1.8.0"
  }
  

  同时修改gradle/wrapper/gradle-wrapper.properties中的Gradle下载地址：

  distributionUrl=https\://services.gradle.org/distributions/gradle-7.5-bin.zip
  

4. 清理项目缓存 #

• 原因：项目缓存文件损坏，导致编译时出现异常。
• 解决：
  1. 执行Android Studio菜单中的Build → Clean Project，然后Build → Rebuild Project。
  2. 若无效，手动删除项目根目录下的.gradle、.build文件夹，以及模块目录下的build文件夹，之后重新同步项目（File → Sync Project with Gradle Files）。

5. 检查布局文件中的Data Binding表达式 #

• 原因：布局文件中的Data Binding表达式存在语法错误，比如字段拼写错误、Observable类的属性未正确绑定。
• 解决：
  • 确认布局中@{...}表达式引用的Observable类属性名称与实际类中的字段一致。
  • 若使用BaseObservable，确保属性添加了@get:Bindable注解，并在setter中调用notifyPropertyChanged(BR.xxx)。

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