嵌套ViewPager2的RecyclerView子项无法填充宽度且高度异常问题

核心问题分析 #

你遇到的问题是嵌套层级导致的测量冲突：外层ScrollView + ViewPager2的0dp+weight布局，让RecyclerView使用match_parent高度时被固定，而常规的inflate方式虽然保证了子项宽度，但无法让RecyclerView自适应内容高度。

解决方案步骤 #

1. 调整目标RecyclerView的布局参数

修改你的“Activity”标签页布局（包含rvItems的布局），将RecyclerView的layout_height从match_parent改为wrap_content：

<?xml version="1.0" encoding="utf-8"?>
<androidx.recyclerview.widget.RecyclerView
    android:id="@+id/rvItems"
    android:layout_width="match_parent"
    android:layout_height="wrap_content" <!-- 修改为wrap_content -->
    android:layout_marginVertical="@dimen/core_margin_s"
    android:orientation="vertical"
    android:nestedScrollingEnabled="false"
    android:background="@android:color/holo_blue_light"
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:android="http://schemas.android.com/apk/res/android" />

2. 自定义LinearLayoutManager解决高度测量问题

默认的LinearLayoutManager在RecyclerView设置wrap_content时，无法准确计算所有子项的总高度（尤其是嵌套在滚动容器里时），需要重写onMeasure方法：

class WrapContentLinearLayoutManager(context: Context) : LinearLayoutManager(context) {

    override fun onMeasure(recycler: RecyclerView.Recycler, state: RecyclerView.State, widthSpec: Int, heightSpec: Int) {
        val heightSize = MeasureSpec.getSize(heightSpec)
        val heightMode = MeasureSpec.getMode(heightSpec)
        
        // 针对wrap_content模式，计算所有子项总高度
        if (heightMode == MeasureSpec.AT_MOST) {
            var totalHeight = 0
            for (i in 0 until itemCount) {
                val view = recycler.getViewForPosition(i)
                measureChild(view, widthSpec, MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED))
                totalHeight += view.measuredHeight
                recycler.recycleView(view)
            }
            // 加上RecyclerView自身的padding
            totalHeight += paddingTop + paddingBottom
            setMeasuredDimension(MeasureSpec.getSize(widthSpec), totalHeight)
        } else {
            super.onMeasure(recycler, state, widthSpec, heightSpec)
        }
    }
}

在代码中为rvItems设置这个自定义LayoutManager：

rvItems.layoutManager = WrapContentLinearLayoutManager(requireContext())

3. 保持Adapter的inflate方式不变

继续使用.inflate(R.layout.your_item_layout, parent, false)来保证子项宽度填充父容器：

override fun onCreateViewHolder(parent: ViewGroup, viewType: Int): RecyclerView.ViewHolder {
    val view = LayoutInflater.from(parent.context).inflate(R.layout.your_item_layout, parent, false)
    return YourViewHolder(view)
}

4. 处理子项中的嵌套RecyclerView

对于子项里的rvDocuments，同样需要：

• 将其layout_height改为wrap_content
• 应用上述自定义的WrapContentLinearLayoutManager

额外优化：调整ViewPager2的高度限制 #

主布局中ViewPager2使用了0dp+weight，外层是ScrollView，可以自定义ViewPager2子类来适配内容高度：

class WrapContentViewPager2(context: Context, attrs: AttributeSet?) : ViewPager2(context, attrs) {
    override fun onMeasure(widthMeasureSpec: Int, heightMeasureSpec: Int) {
        var height = 0
        for (i in 0 until childCount) {
            val child = getChildAt(i)
            child.measure(widthMeasureSpec, MeasureSpec.makeMeasureSpec(0, MeasureSpec.UNSPECIFIED))
            val childHeight = child.measuredHeight
            if (childHeight > height) height = childHeight
        }
        val newHeightMeasureSpec = MeasureSpec.makeMeasureSpec(height, MeasureSpec.EXACTLY)
        super.onMeasure(widthMeasureSpec, newHeightMeasureSpec)
    }
}

在主布局中将ViewPager2替换为这个自定义类：

<com.yourpackage.WrapContentViewPager2
    android:id="@+id/vpIncidentDetails"
    android:layout_width="match_parent"
    android:layout_height="0dp"
    android:layout_weight="1"
    android:paddingTop="24dp"
    android:layout_marginBottom="42dp" />

效果说明 #

通过以上调整，既保证了RecyclerView子项的宽度填充，又让RecyclerView和ViewPager2能自适应内容高度，完美匹配你的目标效果。

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