Compose Pager中animateScrollToPage()在请求焦点页面上失效问题

问题场景 #

我在实现引导流程时，每个页面的TextInputField会在首次组合时通过FocusRequester.requestFocus()请求焦点。此时调用PagerState.animateScrollToPage()切换页面，会出现滚动不彻底、甚至直接跳过目标页面的异常。移除焦点请求逻辑，或者改用同步的scrollToPage()就能正常工作。这个问题在废弃的Accompanist Pager，以及Compose Foundation 1.4.0之后内置的Pager组件中都能稳定复现。

问题原因 #

焦点请求会触发Compose重组，而animateScrollToPage()是异步执行的滚动动画。当焦点请求引发的布局变化（比如软键盘弹出、输入框状态更新）发生时，Pager的测量和布局会被重新计算，直接打断正在进行的滚动动画，导致动画提前终止或状态混乱。

可行解决方案 #

1. 延迟焦点请求，避开滚动动画周期 #

不要在页面首次组合时立即请求焦点，等滚动动画完全结束后再触发。可以通过监听Pager的滚动状态或延迟执行来实现：

LaunchedEffect(pagerState.currentPage) {
    // 等待滚动动画稳定，延迟时间可根据实际场景调整
    delay(100)
    // 确认当前页面是目标页后再请求焦点
    if (pagerState.currentPage == currentPageIndex) {
        focusRequester.requestFocus()
    }
}

或者更精准地监听滚动状态：

LaunchedEffect(pagerState.isScrollInProgress) {
    if (!pagerState.isScrollInProgress) {
        if (pagerState.currentPage == currentPageIndex) {
            focusRequester.requestFocus()
        }
    }
}

2. 用scrollToPage()配合手动平滑动画 #

如果需要平滑滚动效果，可先用同步的scrollToPage()确保页面切换到位，再手动添加过渡动画：

LaunchedEffect(targetPage) {
    // 先同步切换页面，避免重组干扰
    pagerState.scrollToPage(targetPage)
    // 可结合animateFloatAsState等API手动实现平滑过渡效果
    val animateOffset = animateFloatAsState(
        targetValue = 0f,
        animationSpec = tween(durationMillis = 300)
    )
    // 利用Pager的scrollableState控制偏移量（需结合Pager的具体实现调整）
}

3. 布局完成后再请求焦点 #

通过监听布局完成事件，确保Pager滚动状态稳定后再触发焦点请求：

DisposableEffect(Unit) {
    val layoutObserver = ViewTreeObserver.OnGlobalLayoutListener {
        if (!pagerState.isScrollInProgress && pagerState.currentPage == currentPageIndex) {
            focusRequester.requestFocus()
        }
    }
    // 获取当前Compose对应的View并添加监听
    val view = LocalView.current
    view.viewTreeObserver.addOnGlobalLayoutListener(layoutObserver)
    
    onDispose {
        view.viewTreeObserver.removeOnGlobalLayoutListener(layoutObserver)
    }
}

关于是否是Compose固有问题 #

这并非Compose的"固有bug"，而是异步动画与状态重组交互时的典型冲突场景。焦点请求触发的重组会改变组件布局状态，打断Pager的滚动动画执行。这类问题本质是状态变化时机与动画周期的冲突，通过调整状态触发时机即可规避。

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