Flutter 3.10.0中如何获取键盘高度？原方法失效求助

Flutter 3.10.0 + Dart 3.0升级后，MediaQuery.of(context).viewInsets.bottom返回0的问题，并非API废弃，而是新版本中键盘交互逻辑的细节变化，以及上下文使用场景的问题，以下是具体解决思路：

核心原因 #

Flutter 3.10对iOS键盘交互做了优化（比如支持键盘工具栏自适应、拖拽调整），但MediaQuery.viewInsets的核心作用并未改变——问题基本出在上下文不正确或未监听键盘状态变化上。

解决方法 #

1. 确保使用正确的上下文 #

必须从MaterialApp/CupertinoApp的子组件上下文获取MediaQuery，不能直接使用根上下文（比如在MaterialApp同级的Widget里获取）。可以用Builder包裹需要获取键盘高度的组件：

Scaffold(
  body: Builder(
    builder: (context) {
      // 此处context可正确读取viewInsets
      final keyboardHeight = MediaQuery.of(context).viewInsets.bottom;
      return YourWidget();
    },
  ),
)

2. 监听键盘状态的异步变化 #

键盘弹出是异步过程，不能在initState直接同步获取高度，需要通过回调或动画监听：

• 用PostFrameCallback监听初始化后的键盘状态：

@override
void initState() {
  super.initState();
  WidgetsBinding.instance.addPostFrameCallback((_) {
    final keyboardHeight = MediaQuery.of(context).viewInsets.bottom;
    print("键盘高度：$keyboardHeight");
  });
}

• 用AnimatedBuilder实时监听键盘高度变化：

AnimatedBuilder(
  animation: MediaQuery.of(context).viewInsets,
  builder: (context, child) {
    final keyboardHeight = MediaQuery.of(context).viewInsets.bottom;
    // 根据高度动态调整UI
    return Container(
      height: keyboardHeight,
      color: Colors.grey,
    );
  },
)

3. 避免错误的API使用 #

View.of(context).viewInsets.bottom并非替代方案，View的上下文属于底层渲染树节点，无法正确关联到应用的媒体查询配置，所以必须使用MediaQuery方式。

额外检查项 #

• 确认Scaffold的resizeToAvoidBottomInset属性未设为false（该属性控制UI是否上移，虽不影响viewInsets计算，但可能间接导致你误以为高度获取失败）。
• 优先测试真机：部分iOS模拟器的键盘模拟可能存在状态同步延迟。

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