近日，多位 Android 开发者在使用 Jetpack Compose Material3 库时报告了一个令人困惑的行为异常：即使代码中明确将 ModalBottomSheet 的初始状态设置为 SheetState.Expanded，组件在实际运行时依然默认以 PartiallyExpanded（半展开）状态呈现。这一现象已引发社区广泛讨论，并直接影响依赖该组件的应用界面逻辑。

问题重现：预设状态被忽略

根据开发者提供的复现代码，在调用 ModalBottomSheet 时，通常会使用 rememberModalBottomSheetState 创建状态对象，并传入 initialValue = SheetValue.Expanded。然而，无论传入的参数如何，组件首次弹出时始终停留在半展开位置，用户需要手动上滑才能达到完全展开状态。

val sheetState = rememberModalBottomSheetState(
    initialValue = SheetValue.Expanded
)
ModalBottomSheet(
    sheetState = sheetState,
    onDismissRequest = { /* dismiss handling */ }
) {
    // content
}

上述代码理论上应使底部菜单直接展开至全屏内容区域，但实际表现与预期完全不符。初步测试表明，该问题在 Compose BOM 2024.01.00 及后续多个版本中均存在，且与设备 API 级别无关。

影响范围与用户体验

底部菜单是 Material Design 3 中的重要交互组件，通常用于展示扩展选项、表单或详情信息。PartiallyExpanded 状态仅显示内容顶部的一小部分，强迫用户在每次打开菜单时进行额外上滑操作，显著降低流畅度。对于需要直接展示完整信息（如长列表、编辑表单）的应用场景，该 Bug 甚至可能造成功能误判，例如用户以为菜单未加载完毕而反复关闭再打开。

除了初始状态失效外，部分开发者还反馈，PartiallyExpanded 状态下拖动控件的视觉反馈也存在延迟，进一步加剧了交互断裂感。

社区反馈与官方动态

该问题已在 Google Issue Tracker 和 GitHub 的 Material Components Android 仓库中被标记为高优先级 Bug（Issue #XX）。有开发者猜测，问题根源可能在于 ModalBottomSheet 内部默认将 skipPartiallyExpanded 属性设置为 false，且 initialValue 的生效时机滞后于布局测量阶段，导致组件强制回退至半展开高度。

截至目前（2024年8月），Google 官方尚未发布正式修复版本。Jetpack Compose 团队在社区讨论中表示已定位到相关代码，预计将在下一个 Material3 更新（1.3.0-alpha 或 1.2.1）中解决。但该更新暂未提供确切的发布日期。

临时解决方案

在官方补丁到来之前，开发者可通过以下两种方式规避该问题：

  1. 手动控制状态：在 LaunchedEffect 中延迟调用 sheetState.expand()，强制展开。但这会导致视觉上的“跳闪”，体验并不完美。
  2. 禁用半展开行为：设置 skipPartiallyExpanded = true 以完全跳过中间状态，让菜单直接在完全展开和隐藏之间切换。此方法适用于不需要分层高度的简单场景。
val sheetState = rememberModalBottomSheetState(
    skipPartiallyExpanded = true
)

此外，降级至 Material3 1.1.x 版本也是一个选项，但需要注意与 Compose BOM 的兼容性。

结语

作为 Material Design 系统在 Compose 中的核心实现，ModalBottomSheet 的状态管理问题暴露了现代声明式 UI 框架在复杂交互边界上的调试难度。对于正在使用或计划使用该组件的 Android 开发者而言，建议密切关注官方更新日志，并在关键功能上线前做好状态兜底处理。

该事件也再次提醒我们，即便在成熟的组件库中，标称参数与实际行为之间仍可能存在隐式偏差——编写测试用例、留意社区反馈，依然是保障应用稳健性的不可省略环节。