如何在Jetpack Compose中实现Swipe to Refresh下拉刷新功能

你原有代码无法运行的核心原因是：SwipeRefresh是早期Accompanist扩展库提供的临时组件，目前已正式废弃，在新版Jetpack Compose中不会默认提供，未正确引入对应依赖、版本不匹配时会直接出现组件无法识别、功能失效的问题。目前官方已将下拉刷新能力集成到Compose Material3稳定库中，推荐优先使用官方标准实现。

第一步：确认依赖 #

先在模块级build.gradle中确认引入了符合版本要求的Material3依赖：

dependencies {
    // 其余Compose依赖保持原有配置即可
    implementation "androidx.compose.material3:material3:1.2.1"
}

第二步：完整实现代码 #

@OptIn(ExperimentalMaterial3Api::class)
@Composable
fun RefreshableList() {
    // 管理刷新状态
    var isRefreshing by remember { mutableStateOf(false) }
    val pullToRefreshState = rememberPullToRefreshState()
    val coroutineScope = rememberCoroutineScope()

    // 刷新触发逻辑
    val onRefresh: () -> Unit = {
        isRefreshing = true
        coroutineScope.launch {
            // 替换为实际的数据加载逻辑
            delay(1500)
            isRefreshing = false
        }
    }

    Box(
        modifier = Modifier
            .fillMaxSize()
            // 绑定下拉刷新手势监听
            .pullToRefresh(
                state = pullToRefreshState,
                isRefreshing = isRefreshing,
                onRefresh = onRefresh
            )
    ) {
        // 滚动内容区域，以LazyColumn为例
        LazyColumn(
            modifier = Modifier.fillMaxSize()
        ) {
            items(50) { index ->
                ListItem(
                    headlineContent = { Text("列表项 $index") },
                    modifier = Modifier.fillMaxWidth()
                )
            }
        }

        // 下拉刷新状态指示器
        PullToRefreshContainer(
            state = pullToRefreshState,
            modifier = Modifier.align(Alignment.TopCenter)
        )
    }
}

注意：内部的可滚动组件（LazyColumn/滚动Column/LazyRow等）必须设置fillMaxSize()修饰符占满容器空间，否则会出现下拉手势无响应的问题。

如果项目暂时无法迁移到Material3，必须使用原有SwipeRefresh组件，需要额外引入Accompanist对应依赖，注意依赖版本必须和项目当前使用的Compose版本严格匹配：

dependencies {
    implementation "com.google.accompanist:accompanist-swiperefresh:0.32.0"
}

引入依赖后原有代码即可正常运行，同样需要给SwipeRefresh内部的可滚动内容添加fillMaxSize()修饰符，避免手势响应异常。
提示：Accompanist的SwipeRefresh组件已停止维护，不会再更新功能和修复bug，仅适合临时兼容使用。

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