Android Compose中verticalScroll默认滚到底部的原因及解决方法

为什么对话框会默认滚到底部？ #

核心原因是可聚焦控件自动获取焦点时，Compose系统会自动滚动视图以确保焦点控件可见。如果你的对话框底部存在其他可聚焦组件（比如按钮、输入框），或者焦点请求的时机让系统优先触发了自动滚动逻辑，就会出现对话框打开后直接滚到底部的情况。

解决方法 #

以下几种方案可以让对话框首次显示时停在顶部：

1. 调整焦点请求与滚动的执行顺序 #

你之前的代码先请求焦点再滚动，会被系统的自动滚动覆盖。改成先清除焦点、滚动到顶部，等待滚动完成后再请求焦点：

val scrollState = rememberScrollState()
val moduleNameFocus = rememberFocusRequester()
val focusManager = LocalFocusManager.current

LaunchedEffect(Unit) {
    focusManager.clearFocus() // 先清除所有焦点，阻止系统自动滚动
    scrollState.scrollTo(0)
    scrollState.awaitScroll() // 确保滚动完成
    moduleNameFocus.requestFocus()
}

2. 限制滚动容器的最大高度 #

给滚动的Column设置最大高度，避免内容被过度挤压导致系统触发自动滚动：

Column(
    modifier = Modifier
        .fillMaxWidth()
        .maxHeightIn(max = 0.8f * LocalConfiguration.current.screenHeightDp.dp) // 限制为屏幕高度的80%
        .verticalScroll(state = scrollState)
        .padding(vertical = 16.dp),
    horizontalAlignment = Alignment.CenterHorizontally
) {
    FormEditText(
        modifier = Modifier
            .fillMaxWidth()
            .focusRequester(moduleNameFocus)
        // 其他配置
    )
    // 其他内容组件
}

3. 自定义对话框的布局约束 #

修改Dialog的属性，手动控制宽度和高度，避免系统默认布局导致的滚动异常：

Dialog(
    onDismissRequest = { /* 关闭逻辑 */ },
    properties = DialogProperties(usePlatformDefaultWidth = false)
) {
    Surface(
        modifier = Modifier
            .fillMaxWidth(0.9f) // 设置对话框宽度为屏幕的90%
            .wrapContentHeight(),
        shape = MaterialTheme.shapes.medium
    ) {
        // 你的滚动Column内容
    }
}

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