如何修复Jetpack Compose中PullToRefreshBox包裹RecyclerView下拉刷新无响应问题

在一个使用RecyclerView及现有Adapter的遗留Android项目中，尝试通过Compose的PullToRefreshBox实现Material 3风格的下拉刷新功能——将RecyclerView嵌入ComposeView并使用PullToRefreshBox包裹，但RecyclerView可正常滚动，下拉刷新手势却始终无法触发。

已尝试的解决方法 #

• 开启RecyclerView的isNestedScrollingEnabled = true；
• 添加NestedScrollConnection以让父级PullToRefreshBox优先处理滚动事件；
• 手动跟踪RecyclerView滚动位置判断是否处于顶部，以此控制刷新功能的启用/禁用；
• 尝试使用SwipeRefreshLayout替代，但无法将其指示器样式调整为Material 3 Expressive设计风格。

核心实现代码 #

@OptIn(ExperimentalMaterial3Api::class)
private fun setupComposePullRefresh() {
    val composeView = findViewById<ComposeView>(R.id.composeRefresh)

    composeView.layoutParams = composeView.layoutParams.apply {
        width = ConstraintLayout.LayoutParams.MATCH_CONSTRAINT
        height = ConstraintLayout.LayoutParams.MATCH_CONSTRAINT
    }

    composeView.setContent {
        val refreshState by viewModel.refreshState
            .map { state ->
                state is MainViewModel.RefreshState.Loading
            }
            .collectAsState(initial = false)

        val nestedScrollConnection = remember {
            object : NestedScrollConnection {
                override fun onPreScroll(available: Offset, source: NestedScrollSource): Offset {
                    return Offset.Zero
                }

                override suspend fun onPreFling(available: Velocity): Velocity {
                    return Velocity.Zero
                }
            }
        }

        Box(
            modifier = Modifier
                .nestedScroll(nestedScrollConnection)
                .fillMaxSize()
        ) {
            PullToRefreshBox(
                isRefreshing = refreshState,
                onRefresh = { refreshData() },
                modifier = Modifier.fillMaxSize()
            ) {
                AndroidView(
                    factory = { ctx ->
                        val view = LayoutInflater.from(ctx)
                            .inflate(R.layout.main_recycler_view, null, false)

                        val recyclerView = view.findViewById<RecyclerView>(R.id.recyclerView)
                        recyclerView.isNestedScrollingEnabled = true
                        recyclerView.overScrollMode = RecyclerView.OVER_SCROLL_NEVER

                        val scrollListener = object : RecyclerView.OnScrollListener() {
                            override fun onScrolled(recyclerView: RecyclerView, dx: Int, dy: Int) {
                                super.onScrolled(recyclerView, dx, dy)
                                val layoutManager = recyclerView.layoutManager as LinearLayoutManager
                                val firstVisibleItemPosition = layoutManager.findFirstVisibleItemPosition()
                                val offset = layoutManager.findViewByPosition(firstVisibleItemPosition)?.top ?: 0
                            }
                        }

                        recyclerView.addOnScrollListener(scrollListener)

                        // 绑定 Adapter
                        onRecyclerViewReady?.invoke(recyclerView)
                        onRecyclerViewReady = null

                        view
                    },
                    modifier = Modifier.fillMaxSize()
                )
            }
        }
    }
}

布局文件 #

main_recycler_view.xml #

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:tools="http://schemas.android.com/tools"
    xmlns:app="http://schemas.android.com/apk/res-auto">

    <androidx.recyclerview.widget.RecyclerView
        android:id="@+id/recyclerView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clipToPadding="false"
        android:paddingBottom="80dp"
        app:layout_constraintBottom_toBottomOf="parent"
        android:nestedScrollingEnabled="true"
        android:overScrollMode="never"
        tools:listitem="@layout/item_layout" />

</androidx.constraintlayout.widget.ConstraintLayout>

activity_main.xml #

...
<androidx.compose.ui.platform.ComposeView
        android:id="@+id/composeRefresh"
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:layout_marginVertical="0dp"
        android:layout_marginHorizontal="8dp"
        app:layout_constraintTop_toBottomOf="@id/tabLayout"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintBottom_toBottomOf="parent" />
...

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