ConstraintLayout嵌套RecyclerView动态高度布局异常求助

核心问题分析 #

原布局的冲突点在于：

• ConstraintLayout同时设置wrap_content高度、maxHeight以及app:layout_constraintBottom_toBottomOf="parent"，导致布局高度计算逻辑混乱，列表项超过6个时，RecyclerView的可用空间被挤压，最后几项被截断。
• RecyclerView使用wrap_content高度，在父布局高度被限制时，无法自适应填充剩余可滚动空间。

步骤1：修改布局文件 #

调整ConstraintLayout和RecyclerView的约束与高度设置，确保RecyclerView在组件高度固定时能占据正确的可滚动空间：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
    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"
    android:id="@+id/component_card"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@drawable/background_card_with_radius"
    android:paddingStart="16px"
    android:paddingEnd="16px"
    android:paddingTop="32px"
    android:paddingBottom="32px"
    android:clipToPadding="false"
    tools:ignore="HardcodedColorValue">

    <TextView
        android:id="@+id/title"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        style="@style/StandardText"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        android:textAlignment="viewStart"
        android:text="@string/title_hdr" />

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/list_recycler_view"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:nestedScrollingEnabled="true"
        app:layout_constraintTop_toBottomOf="@+id/title"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:divider_visibility="gone"
        android:scrollbars="vertical"
        android:fadeScrollbars="false"
        android:scrollbarStyle="outsideOverlay" />

</androidx.constraintlayout.widget.ConstraintLayout>

关键修改点：

• 移除ConstraintLayout的android:maxHeight、app:layout_constraintHeight_max和app:layout_constraintBottom_toBottomOf="parent"，改为通过代码动态控制高度。
• 将RecyclerView的layout_height设为0dp，并添加app:layout_constraintBottom_toBottomOf="parent"，使其填充标题到组件底部的所有空间，确保组件高度固定时能滚动显示全部列表项。
• 恢复android:nestedScrollingEnabled="true"（无需嵌套NestedScrollView，RecyclerView自身支持滚动）。

步骤2：代码中动态控制组件高度 #

在设置RecyclerView的Adapter数据后，根据列表项数量调整组件高度：

// 在CardComponent的逻辑代码中
val itemCount = adapter.itemCount
val layoutParams = component_card.layoutParams
if (itemCount <= 6) {
    // 列表项≤6时，组件自适应高度
    layoutParams.height = ViewGroup.LayoutParams.WRAP_CONTENT
} else {
    // 列表项>6时，组件固定为1000px（若需dp转px，用下方工具方法）
    layoutParams.height = 1000
}
component_card.layoutParams = layoutParams
list_recycler_view.requestLayout()

如果需要将dp单位转换为px，可添加工具方法：

fun dpToPx(context: Context, dp: Int): Int {
    return (dp * context.resources.displayMetrics.density).toInt()
}
// 使用示例：layoutParams.height = dpToPx(context, 300)

额外注意事项 #

• 禁止嵌套NestedScrollView，这会导致RecyclerView的复用机制失效，且高度计算逻辑混乱。
• 确保RecyclerView的Item布局高度可正确计算，否则wrap_content模式下可能出现高度异常。

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