Android <include>标签约束失效问题求助

问题现象 #

一直使用ViewBinding + DataBinding实现可复用布局，近期遇到标签异常：添加到ConstraintLayout后，被包含布局不遵循宽高设置，直接占满父布局，约束锚点固定在父布局左上角，无法与父布局内其他视图建立约束，非视图则正常。

项目配置 #

• Android Studio：Koala
• AGP：8.6.1
• Gradle版本：8.10.2
• 开发语言：Kotlin

问题示意图 #

相关代码 #

父布局代码 #

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools">

    <data>
        <import type="android.view.View" />
    </data>

    <androidx.constraintlayout.widget.ConstraintLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <TextView
            android:id="@+id/textView"
            android:layout_width="0dp"
            android:layout_height="wrap_content"
            android:text="NOT USING INCLUDE TAG"
            android:gravity="center"
            app:layout_constraintBottom_toBottomOf="parent"
            app:layout_constraintEnd_toEndOf="parent"
            app:layout_constraintStart_toStartOf="parent"
            app:layout_constraintTop_toTopOf="@+id/include" />

        <include
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:id="@+id/include"
            layout="@layout/test_include" />

    </androidx.constraintlayout.widget.ConstraintLayout>
</layout>

被包含布局代码 #

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <data>
        <variable
            name="binderModel"
            type="com.toxodevelopment.cinefilo.ui.UIButtonBinderModel" />
    </data>

    <RelativeLayout
        android:layout_width="wrap_content"
        android:layout_height="wrap_content">

        <com.google.android.material.button.MaterialButton
            android:id="@+id/btn_regular"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:layout_centerInParent="true"
            android:onClickListener="@{binderModel.onClickListener::onClick}"
            android:tag="@{binderModel.text}"
            android:text="@{binderModel.text}"
            tools:text="REGULAR" />
    </RelativeLayout>
</layout>

已知临时兼容情况 #

• 切换至Android Studio HEDGEHOG + AGP7.1.3 + Gradle8.10.2 + Material Design2，问题消失；切回Material3仅第一个正常，其余仍异常
• Android Studio IGUANA + AGP8.3.2 + Gradle8.7 + Material Design2可正常使用
• 升级至Android Studio Koala及以上版本，问题复现

彻底解决方案 #

1. 给标签显式添加约束 #

在父布局的标签上直接设置完整的约束属性，不要依赖被包含布局的内部约束传递：

<include
    android:id="@+id/include"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    layout="@layout/test_include"
    app:layout_constraintStart_toStartOf="parent"
    app:layout_constraintTop_toTopOf="parent" />

ConstraintLayout对的约束解析仅识别标签本身的属性，不会继承被包含布局根节点的约束，这是核心规则。

2. 简化被包含布局的根结构 #

被包含布局的根RelativeLayout可能与ConstraintLayout的布局解析逻辑冲突，可直接将MaterialButton作为根布局，或替换为ConstraintLayout：
修改后的被包含布局：

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

    <data>
        <variable
            name="binderModel"
            type="com.toxodevelopment.cinefilo.ui.UIButtonBinderModel" />
    </data>

    <com.google.android.material.button.MaterialButton
        android:id="@+id/btn_regular"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:onClickListener="@{binderModel.onClickListener::onClick}"
        android:tag="@{binderModel.text}"
        android:text="@{binderModel.text}"
        tools:text="REGULAR" />
</layout>

若需保留根布局，替换为ConstraintLayout并确保根布局宽高为wrap_content，内部视图约束正确。

3. 升级ConstraintLayout到最新稳定版 #

更新androidx.constraintlayout:constraintlayout依赖，新版本修复了多个与DataBinding结合的解析bug：

// app/build.gradle.kts
dependencies {
    implementation("androidx.constraintlayout:constraintlayout:2.1.4") // 或更高稳定版
}

4. 禁用AGP资源优化（临时排查） #

若上述方法无效，可临时禁用AGP的布局编译优化，在gradle.properties中添加：

android.enableResourceOptimizations=false

注意：此操作会降低编译速度，仅用于排查问题，不建议长期使用。

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