Android RecyclerView自动滚动异常：加载图片后位置偏移问题

核心原因 #

开启reverseLayout="true"后，RecyclerView的初始滚动位置依赖列表项的准确高度，但Glide异步加载图片会导致列表项布局完成后高度突变，触发RecyclerView重新测量布局，进而打乱已设置的滚动位置。你之前监听LoadState滚动到位置0的操作，仅在数据加载完成时执行，此时图片还未加载完毕，后续图片加载完成后的布局变化就会导致滚动偏移。

具体解决方案 #

1. 给图片控件设置预占高度（或固定比例）

在聊天项布局中，给图片控件设置固定宽高，或用占位图预留与实际图片一致的宽高比例，避免图片加载后列表项高度突变。示例：

<ImageView
    android:id="@+id/message_image"
    android:layout_width="120dp"
    android:layout_height="120dp"
    android:scaleType="centerCrop"
    android:src="@drawable/image_placeholder" />

如果图片宽高比例不固定，可提前从接口获取图片的宽高数据，动态计算并设置ImageView的布局参数，确保加载前就有准确的占位高度。

2. 监听图片加载完成后校正滚动位置

借助Glide的listener监听图片加载完成事件，等可见列表项的图片加载完毕后再执行滚动，同时避免频繁触发滚动操作。在Adapter的onBindViewHolder中处理：

override fun onBindViewHolder(holder: ChatViewHolder, position: Int) {
    val item = getItem(position)
    item?.imageUrl?.let { url ->
        Glide.with(holder.itemView.context)
            .load(url)
            .listener(object : RequestListener<Drawable> {
                override fun onLoadFailed(
                    e: GlideException?,
                    model: Any?,
                    target: Target<Drawable>?,
                    isFirstResource: Boolean
                ): Boolean {
                    correctScrollPosition()
                    return false
                }

                override fun onResourceReady(
                    resource: Drawable?,
                    model: Any?,
                    target: Target<Drawable>?,
                    dataSource: DataSource?,
                    isFirstResource: Boolean
                ): Boolean {
                    correctScrollPosition()
                    return false
                }
            })
            .into(holder.messageImage)
    }
}

// 避免重复触发滚动的校正方法
private var scrollJob: Job? = null
private fun correctScrollPosition() {
    scrollJob?.cancel()
    scrollJob = MainScope().launch {
        delay(100) // 短延迟确保布局更新完成
        binding.recyclerView.scrollToPosition(0)
    }
}

3. 优化LoadState监听的滚动时机

不要在LoadState变为NotLoading时立即滚动，而是等待RecyclerView初始布局完成后再执行：

adapter.loadStateFlow
    .distinctUntilChangedBy { it.refresh }
    .filter { it.refresh is LoadState.NotLoading }
    .collect {
        binding.recyclerView.viewTreeObserver.addOnGlobalLayoutListener(object : ViewTreeObserver.OnGlobalLayoutListener {
            override fun onGlobalLayout() {
                binding.recyclerView.viewTreeObserver.removeOnGlobalLayoutListener(this)
                binding.recyclerView.scrollToPosition(0)
            }
        })
    }

4. 配合开启stackFromEnd并禁用自动测量

在布局管理器中开启stackFromEnd，配合reverseLayout确保列表默认从底部开始布局；同时禁用自动测量避免布局变动影响滚动：

val layoutManager = LinearLayoutManager(context).apply {
    reverseLayout = true
    stackFromEnd = true
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        isAutoMeasureEnabled = false
    }
}
binding.recyclerView.layoutManager = layoutManager

总结 #

最有效的解决路径是给图片控件预占准确高度+监听图片加载完成后校正滚动位置，从根源避免布局高度突变导致的滚动偏移。

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