PAYATHON 2026

如何在 Composable 外部让 LazyColumn 滚动到指定条目?

排障赵师傅

可以在 Player.Listener 这样的普通回调中控制 LazyColumn。建议在界面中用 rememberLazyListState() 创建列表状态,用 rememberCoroutineScope() 启动滚动协程,让监听器持有这两个对象。监听器随界面注册和移除,无需使用全局变量或 GlobalScope。

scrollToItem() 是 suspend 函数,调用它的代码可以写在 Composable 函数体外,但要使用同一个 LazyListState,并在合适的协程上下文和生命周期内执行。

崩溃与 GlobalScope 有什么关系?

原代码使用了 GlobalScope.launch:

GlobalScope.launch {
    listState.scrollToItem(index)
}

这里没有指定调度器,因此使用 Dispatchers.Default,通常在后台线程执行。scrollToItem() 会更新列表滚动位置,也可能触发重新测量。从后台线程发起这些操作,可能与主线程正在执行的布局发生冲突。

下面的异常表示发生了测量、布局重入:

performMeasureAndLayout called during measure layout

这段代码应先修正从后台线程操作列表的问题。不过,仅凭这份堆栈,还不能断定这是唯一原因,也不能认定某个 Compose 版本存在缺陷。

堆栈中没有业务代码也不奇怪。滚动改变了布局状态,异常可能到后续绘制时才暴露,此时调用栈已经回到 Android 和 Compose 的绘制流程。

在界面中创建状态,在监听器中使用

示例使用 Media3,并保留 fileIndex() 映射和高亮操作。这里假设 Player 的 applicationLooper 是主线程,这是界面播放器的常见配置。

import androidx.compose.foundation.lazy.LazyColumn
import androidx.compose.foundation.lazy.rememberLazyListState
import androidx.compose.material3.Text
import androidx.compose.runtime.*
import androidx.media3.common.MediaItem
import androidx.media3.common.Player
import kotlinx.coroutines.launch

@Composable
fun PlayerPlaylist(
    player: Player,
    titles: List<String>,
    fileIndex: (Int) -> Int,
    highlightCurrentlyPlaying: (Int, Boolean) -> Unit,
) {
    val listState = rememberLazyListState()
    val scope = rememberCoroutineScope()

    // 监听器可以继续存在,同时读取重组后更新的参数。
    val latestTitles by rememberUpdatedState(titles)
    val latestFileIndex by rememberUpdatedState(fileIndex)
    val latestHighlight by rememberUpdatedState(highlightCurrentlyPlaying)

    DisposableEffect(player, listState, scope) {
        val listener = object : Player.Listener {
            override fun onMediaItemTransition(
                mediaItem: MediaItem?,
                reason: Int,
            ) {
                scope.launch {
                    val mediaIndex = player.currentMediaItemIndex
                    if (mediaIndex < 0) return@launch

                    val index = latestFileIndex(mediaIndex)
                    if (index !in latestTitles.indices) return@launch

                    latestHighlight(index, true)
                    listState.scrollToItem(index)
                }
            }
        }

        player.addListener(listener)

        onDispose {
            player.removeListener(listener)
        }
    }

    LazyColumn(state = listState) {
        items(count = titles.size) { index ->
            Text(text = titles[index])
        }
    }
}

onMediaItemTransition() 是普通函数,通过闭包访问 scope 和 listState,再用 launch 调用挂起函数,启动后无需等待滚动完成。

这些 API 的作用分别是:

  • rememberLazyListState() 在重组之间保留同一个列表状态,并支持滚动位置的保存与恢复。
  • rememberCoroutineScope() 提供与当前组合位置绑定的作用域。在 Android Compose 界面中,它使用适合 UI 操作的协程上下文;该位置离开组合后,作用域会取消。
  • DisposableEffect 管理监听器的注册与移除,避免每次重组都添加新监听器。
  • rememberUpdatedState() 让已注册的监听器读取最新参数,避免一直使用注册时捕获的旧列表或旧回调。

如果使用旧的 ExoPlayer 包,需要调整 Player、MediaItem 的 import。如果播放器运行在专用线程上,还要按照它的 applicationLooper 安排播放器访问和监听器管理,不能直接套用主线程假设。

监听器已经放在界面外部怎么办?

如果监听器属于 Activity、ViewModel 或播放服务,可以让它更新“当前播放条目”状态,由界面观察状态并滚动。播放服务通常比界面存活得更久,这样更容易管理两者的生命周期。

例如,界面接收已经映射好的列表索引:

@Composable
fun Playlist(
    titles: List<String>,
    currentIndex: Int?,
) {
    val listState = rememberLazyListState()

    LaunchedEffect(currentIndex, titles) {
        val index = currentIndex ?: return@LaunchedEffect
        if (index in titles.indices) {
            listState.scrollToItem(index)
        }
    }

    LazyColumn(state = listState) {
        items(count = titles.size) { index ->
            Text(text = titles[index])
        }
    }
}

外部监听器负责更新 currentIndex,例如更新 ViewModel 中的 StateFlow。界面收集状态后,将索引传入这个函数,播放逻辑就不必持有列表的 UI 状态。

LaunchedEffect 会在 key 改变时取消上一次任务并重新执行,离开组合时也会取消任务。这里把 titles 也作为 key,让列表数据更新后重新检查目标位置。这种写法适合让列表跟随当前播放条目;如果需要对同一个索引反复执行滚动,应另外设计滚动事件。

如果只是父组件和子组件都要访问列表状态,将 LazyListState 提升到共同父组件,再通过参数传入即可。手动调用 LazyListState() 本身合法。使用全局变量的问题在于所有权不清晰:页面退出后,状态仍然存在,还可能被多个列表同时使用。

“启动后无需等待”也需要明确何时取消

scope.launch { ... } 启动后会立即返回 Job,调用方可以不等待任务完成,因此无需为 fire and forget 专门创建全局作用域。

根据操作的实际所有者选择作用域:

  • 列表滚动等界面操作,优先使用 rememberCoroutineScope() 或 LaunchedEffect。
  • Activity、Fragment 自己管理的任务,可以使用对应的 lifecycleScope。
  • ViewModel 管理的业务任务,可以使用 viewModelScope,再把结果暴露给界面。

即使不担心内存泄漏,页面退出后继续滚动旧列表也没有意义。GlobalScope 无法随页面退出取消任务,改成 GlobalScope.launch(Dispatchers.Main) 也只解决了调度线程的问题。

还要确认 fileIndex() 返回的是 LazyColumn 的实际条目索引。如果列表包含分组标题、占位条目,或者经过筛选、排序,就不能直接把播放队列索引作为滚动索引。示例通过范围检查跳过暂时无效的目标。如果需要平滑滚动,可以将 scrollToItem(index) 换成 animateScrollToItem(index),继续使用同一个组合协程作用域。

备注:内容仅供参考。