Jetpack Compose 开启reverseLayout的LazyColumn在Talkback下滚动异常

该异常属于Jetpack Compose Foundation组件的已知历史bug，核心原因是reverseLayout开启场景下，无障碍遍历逻辑没有适配倒序布局的滚动方向，上一项遍历动作没有和列表向上加载的逻辑绑定，导致焦点无法触发滚动直接跳转到列表头部。

修复方案 #

方案1（推荐）：升级依赖版本 #

将androidx.compose.foundation:foundation依赖升级到1.5.0及以上正式版本，该版本官方已完整修复倒序列表的无障碍遍历联动问题，升级后原有业务代码无需额外修改即可正常运行。

方案2（兼容低版本）：自定义语义适配 #

如果暂时无法升级Compose版本，可以通过自定义列表语义属性和焦点动作兼容解决，修复后的完整代码如下：

import androidx.compose.foundation.lazy.rememberLazyListState
import androidx.compose.ui.semantics.CollectionInfo
import androidx.compose.ui.semantics.CustomAccessibilityAction
import androidx.compose.ui.semantics.semantics
import androidx.compose.ui.semantics.selectionMode
import kotlinx.coroutines.launch

// 页面级协程作用域，可通过rememberCoroutineScope获取
val coroutineScope = rememberCoroutineScope()
val items = List(100) { "Item at: $it" }
val listState = rememberLazyListState()

LazyColumn(
    modifier = Modifier
        .fillMaxSize()
        .semantics {
            // 明确声明列表的集合信息，让无障碍服务识别正确的遍历顺序
            collectionInfo = CollectionInfo(
                rowCount = items.size,
                columnCount = 1,
                isHierarchical = false,
                isOrdered = true,
                selectionMode = SelectionMode.None
            )
            // 重写无障碍上一项动作，绑定倒序滚动逻辑
            customActions = listOf(
                CustomAccessibilityAction("上一项") {
                    val targetIndex = listState.firstVisibleItemIndex + 1
                    if (targetIndex < items.size) {
                        coroutineScope.launch {
                            listState.animateScrollToItem(targetIndex)
                        }
                        true
                    } else false
                }
            )
        },
    state = listState,
    reverseLayout = true,
    verticalArrangement = Arrangement.spacedBy(10.dp)
) {
    // 直接使用LazyColumn提供的items扩展加载列表，不要用forEach逐个添加item
    items(items.size) { index ->
        Text(
            text = items[index],
            color = Color.White,
            // 给子项添加focusable修饰符，确保无障碍服务可正确识别可聚焦节点
            modifier = Modifier.focusable()
        )
    }
}

额外注意事项 #

• 不要通过forEach循环逐个调用item方法添加列表项，LazyColumn原生的items扩展会自动给每个子项绑定正确的无障碍索引，避免遍历顺序混乱。
• 所有可聚焦的列表子项都需要添加focusable()修饰符，避免无障碍服务跳过节点。

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