嵌套RecyclerView滚动偏移同步异常：新填充列表偏移量始终为0

问题根源 #

核心问题在于未完全显示到屏幕的RecyclerView还未完成布局测量，此时调用computeVerticalScrollOffset()会返回0；同时在onCreateViewHolder/onBindViewHolder中直接调用scrollBy也不会生效——因为RecyclerView的子View还未完成布局，滚动指令无法被正确执行。

修复方案 #

1. 给嵌套RecyclerView添加布局完成监听

在onBindViewHolder中，为嵌套的detailsRecyclerView添加布局完成监听，等布局就绪后再同步滚动偏移：

override fun onBindViewHolder(holder: ViewHolder, position: Int) {
    // ... 其他绑定逻辑
    
    val targetOffset = recyclerViewSyncHelper.getAbsoluteOffset() ?: 0
    holder.detailsRecyclerView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
        override fun onGlobalLayout() {
            // 移除监听避免重复触发
            holder.detailsRecyclerView.viewTreeObserver.removeOnGlobalLayoutListener(this)
            // 同步偏移量
            val currentOffset = holder.detailsRecyclerView.computeVerticalScrollOffset()
            if (targetOffset != currentOffset) {
                holder.detailsRecyclerView.scrollBy(0, targetOffset - currentOffset)
            }
        }
    })
}

2. 修正RecyclerViewSyncHelper逻辑

原Helper存在隐患：当滚动的RecyclerView返回0偏移时会跳过同步，而初始状态下所有列表偏移都是0，需要确保absoluteOffset能正确初始化并及时更新：

class RecyclerViewSyncHelper() {
    private var absoluteOffset: Int = 0
    private val verticalRecyclerViews = mutableListOf<RecyclerView>()

    fun getAbsoluteOffset(): Int = absoluteOffset

    fun addVerticalRecyclerView(recyclerView: RecyclerView) {
        recyclerView.clearOnScrollListeners()
        recyclerView.addOnScrollListener(onScroll)
        verticalRecyclerViews.add(recyclerView)
        
        // 初始化时直接同步基准偏移，不跳过0值
        matchOffset(verticalRecyclerViews[0].computeVerticalScrollOffset())
    }

    fun removeVerticalRecyclerView(recyclerView: RecyclerView) {
        verticalRecyclerViews.remove(recyclerView)
    }

    private val onScroll = object : RecyclerView.OnScrollListener() {
        override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
            super.onScrolled(recyclerView, dx, dy)
            val value = recyclerView.computeVerticalScrollOffset()
            // 去掉value !=0的判断，确保所有滚动事件都能同步
            matchOffset(value)
        }
    }

    fun matchOffset(offset: Int = absoluteOffset) {
        this.absoluteOffset = offset // 先更新全局偏移量
        verticalRecyclerViews.forEach { recyclerView ->
            val currentOffset = recyclerView.computeVerticalScrollOffset()
            if (offset != currentOffset) {
                recyclerView.scrollBy(0, offset - currentOffset)
            }
        }
    }
}

3. 水平RecyclerView滚动时触发同步

当水平RecyclerView滚动，嵌套RecyclerView进入屏幕时，主动触发同步操作：

horizontalRecyclerView.addOnScrollListener(object : RecyclerView.OnScrollListener() {
    override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
        super.onScrolled(recyclerView, dx, dy)
        // 获取当前可见的ViewHolder，触发嵌套RecyclerView同步
        val layoutManager = recyclerView.layoutManager as LinearLayoutManager
        val firstVisiblePos = layoutManager.findFirstVisibleItemPosition()
        val lastVisiblePos = layoutManager.findLastVisibleItemPosition()
        
        for (pos in firstVisiblePos..lastVisiblePos) {
            val holder = recyclerView.findViewHolderForAdapterPosition(pos) as? YourHorizontalViewHolder
            holder?.detailsRecyclerView?.let { rv ->
                val targetOffset = recyclerViewSyncHelper.getAbsoluteOffset()
                val currentOffset = rv.computeVerticalScrollOffset()
                if (targetOffset != currentOffset) {
                    rv.scrollBy(0, targetOffset - currentOffset)
                }
            }
        }
    }
})

关键说明 #

• 必须等RecyclerView完成布局（onGlobalLayout触发）后再执行滚动操作，此时滚动参数才有效
• 去掉SyncHelper中value !=0的判断，确保初始偏移和滚动到顶部的情况都能同步
• 水平RecyclerView滚动时，主动触发可见区域内嵌套RecyclerView的同步，避免进入屏幕后偏移不一致

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