如何在Compose中用Paging3与LazyColumn处理API结果变更的重复Key错误

核心问题分析 #

你遇到的错误是因为服务器返回的新分页数据中包含了已加载过的条目（uuid重复），而LazyColumn的key要求全局唯一，因此触发了Key was already used异常。要保留key的性能优势，需要从数据层或分页逻辑入手解决重复数据问题。

可行解决方案 #

1. 在PagingData流中全局去重 #

利用Paging3的map和distinctBy操作，在ViewModel层对分页数据做全局去重，确保每个uuid只出现一次：

// ViewModel中的PagingFlow处理
val pagingListFlow = Pager(
    config = PagingConfig(pageSize = 50),
    pagingSourceFactory = { YourPagingSource(apiService) }
).flow
    .map { pagingData ->
        // 按uuid去重，保证整个分页流中无重复条目
        pagingData.distinctBy { it.uuid }
    }
    .cachedIn(viewModelScope)

这个方案无需修改服务器逻辑，直接在客户端过滤重复数据，能快速解决问题。注意：distinctBy会遍历当前PagingData中的所有条目，但因为是分页加载，单页数据量有限，性能影响可以忽略。

2. 优化服务器分页逻辑（推荐长期方案） #

客户端去重只是临时 workaround，根源问题是服务器分页返回了重复数据。建议调整服务器的分页参数：

• 放弃使用基于offset或page的分页（这种方式在数据顺序变更时极易出现重复）；
• 改用基于游标（Cursor）的分页：每次请求下一页时，传递当前页最后一条数据的唯一标识（比如uuid或更新时间戳），服务器以此为起点返回后续数据。
  这样能从根源避免新页包含已加载过的条目，同时保证分页逻辑的稳定性。

3. 在PagingSource内部处理重复数据 #

如果不想在ViewModel层处理，可以在自定义的PagingSource的load方法中，对服务器返回的当前页数据做去重：

// 自定义PagingSource中维护已加载的uuid集合
private val loadedUuids = mutableSetOf<String>()

override suspend fun load(params: LoadParams<Int>): LoadResult<Int, YourData> {
    return try {
        val currentPage = params.key ?: 1
        val response = apiService.fetchData(page = currentPage, pageSize = 50)
        val newData = response.data
        
        // 过滤掉已加载的条目
        val filteredData = newData.filter { !loadedUuids.contains(it.uuid) }
        loadedUuids.addAll(filteredData.map { it.uuid })
        
        LoadResult.Page(
            data = filteredData,
            prevKey = if (currentPage == 1) null else currentPage - 1,
            nextKey = if (filteredData.isEmpty()) null else currentPage + 1
        )
    } catch (e: Exception) {
        LoadResult.Error(e)
    }
}

// 下拉刷新时清空已加载集合
override fun invalidate() {
    loadedUuids.clear()
    super.invalidate()
}

这种方式需要在PagingSource中维护已加载的uuid集合，注意在下拉刷新时清空集合，避免状态残留。

总结 #

优先选择**方案2（优化服务器分页）从根源解决问题；如果暂时无法修改服务器，用方案1（PagingData去重）**最简便且对性能影响最小；方案3适合需要在数据源层统一处理的场景。

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