Compose LazyVerticalStaggeredGrid升级后Item尺寸计算异常问题

问题背景 #

升级至 androidx.compose:compose-bom:2024.01.00 后，LazyVerticalGrid 和 LazyVerticalStaggeredGrid 出现异常：滚动到底部后向上回滚时，部分Item的尺寸计算错误。该问题在1.5.4版本中未出现，且UI库更新日志中提到了lookahead相关变更。

可能关联原因 #

2024.01.00 BOM对应的Compose UI版本对lookahead布局系统做了调整——这个系统原本是用来提前测量布局、优化滚动流畅度的，但在Lazy组件的回滚场景下，新的测量逻辑可能出现以下问题：

• 回滚时复用的Item未触发正确的重新测量，沿用了之前的缓存尺寸
• 包含动态内容（比如自适应文本、异步加载图片）的Item，lookahead的缓存机制没有及时刷新尺寸信息

临时修复方案 #

1. 禁用当前组件的lookahead：
   通过CompositionLocalProvider强制关闭目标Lazy组件的lookahead优化，验证是否是该特性导致的问题：

CompositionLocalProvider(LocalLookaheadScope provides null) {
    LazyVerticalGrid(
        columns = GridCells.Fixed(2),
        content = { /* 你的Item列表内容 */ }
    )
}

2. 强制Item重新组合测量：
   给Item添加包含滚动状态的key，确保回滚时触发Item的重新组合和测量：

val scrollState = rememberLazyGridState()
LazyVerticalGrid(
    state = scrollState,
    columns = GridCells.Fixed(2),
) {
    items(items, key = { item -> "${item.id}_${scrollState.firstVisibleItemIndex}" }) { item ->
        // 你的Item布局
    }
}

3. 临时降级BOM版本：
   如果需要快速恢复正常功能，可以暂时降级到androidx.compose:compose-bom:2023.10.01（这个版本对应UI 1.5.4的稳定兼容版本），等官方修复后再升级。

进一步排查建议 #

• 简化Item布局，逐步移除异步加载元素、可变文本等动态内容，定位到底是哪个组件触发了尺寸异常
• 检查Item是否使用了wrapContentSize、weight等可能受lookahead测量逻辑影响的修饰符
• 确认你的Item是否依赖父容器的动态尺寸，这种场景下lookahead的预测量容易出现偏差

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