HorizontalPager索引越界异常：动态列表下的正确使用方法

核心问题分析 #

本质是PagerState的pageCount没有及时跟随imageUrlList的长度更新——当列表从24条缩到6条时，PagerState还保留旧的pageCount，滑动到超过6的索引时就会触发IndexOutOfBoundException。

可行解决步骤 #

1. 让PagerState实时绑定列表长度 #

不要只在初始化时传一次列表大小，改用lambda形式传递pageCount，确保每次重组都取最新的列表长度：

val pagerState = rememberPagerState(
    pageCount = { imageUrlList.size }
)

之前直接传imageUrlList.size只会在首次组合生效，后续列表变化不会自动更新pageCount；lambda形式会在每次重组时重新计算，保证pageCount和列表长度同步。

2. 给HorizontalPager加key，强制列表变化时重建 #

当imageUrlList的内容或长度发生根本性变化时，给HorizontalPager设置唯一key，触发整个Pager组件重建，确保PagerState完全重置：

HorizontalPager(
    state = pagerState,
    key = imageUrlList.hashCode()
) { page ->
    // 先做索引校验兜底
    if (page < imageUrlList.size) {
        Image(
            painter = rememberAsyncImagePainter(imageUrlList[page]),
            contentDescription = null
        )
    } else {
        // 索引越界时显示占位布局
        Box(modifier = Modifier.fillMaxSize())
    }
}

索引校验是最后一道防线，即使PagerState没及时更新，也不会直接崩溃。

3. 监听列表变化，主动修正当前page位置 #

如果上述方法仍有极端情况，可手动监听列表长度变化，当当前选中的page超过新列表长度时，主动跳转到合法索引：

LaunchedEffect(imageUrlList.size) {
    if (imageUrlList.isNotEmpty() && pagerState.currentPage >= imageUrlList.size) {
        pagerState.animateScrollToPage(imageUrlList.size - 1)
    }
}

这个LaunchedEffect会在列表长度变化时触发，确保当前page始终在合法范围内。

4. 确保列表更新能触发重组 #

如果用可变列表，不要直接在原列表上修改（比如add/remove），每次更新都生成新的列表实例（比如用toList()或重新创建ImmutableList），这样Compose才能感知到列表变化，触发重组。

总结 #

优先用lambda形式绑定pageCount，配合HorizontalPager的key和索引兜底校验，基本能解决绝大多数场景的索引越界问题；极端情况再用LaunchedEffect主动修正page位置。

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