Flutter 又迎大坑修改？iOS 26 键盘变化可能带来大量底层改动

又是一个小问题可能带来的大改动，感觉官方在评估的时候，有点过分细节了。

这个问题来自去年底的 #179482 issue ，Flutter 在 iOS 26 上，某些场景会因为出现半透明键盘，而页面底下本来应该被键盘遮挡的 Widget，由于默认没有被绘制，从而出现键盘背景颜色 UI 异常：

虽然问题看起来是一个圆角问题，但是实际上这是iOS 26 系统键盘增加了“半透明”后带来的问题，Flutter 在键盘后面那一层在某些场景下没有正确渲染内容，导致键盘半透明区域透出来的不是底下 BottomSheet 的真实内容，而是一整块黑色区域。

issue 提到问题，问题最明显的场景主要出现在 iOS 26 的showModalBottomSheet()下。

为什么会这样？首先就是你的 App 目前是否使用了最新 Xcode 26 ，以及在Info.plist里有没有使用UIDesignRequiresCompatibility = YES让 App继续使用旧的系统设计风格：

通过上面前两张图我们可以看到，iOS 26 正常情况下，系统键盘其实是会出现半透明效果并且具备圆角，虽然透明效果不是特别明显，但是对比后两张图里，可以看到微信和淘宝还是保留着原本的 iOS 18 的直角效果。

如果还是保留原本风格，其实并不会遇到这个问题。

所以这个 issue 首先是需要在 Xcode 26 下，并且没有关闭 Liquid Glass 适配的情况下才会遇到，当然，就算是 iOS 26 场景，一般情况下也不会有什么大问题，比如下图直接在界面内使用一个TextField，其实并不会有明显问题：

问题还是主要出现在类似showModalBottomSheet的场景，特别是在背景色透明的时候，虽然我们设置了backgroundColor: Colors.transparent，**但是在 Flutter 里，某些时候 UI 并不会“在键盘背后继续画” ** ，因为在 iOS 26 之前，Flutter（以及很多跨平台框架）都默认：

系统键盘 = 完全不透明的遮挡物，所以 Flutter 的 pipeline 会认为键盘区域背后不需要特殊关注。

实际上类似同样的问题，在 RN 里也是存在，甚至对于 CMP 来说也是存在不一样的问题，所以对于 CMP 来说，才会有 1.10 Interop views 新特性 Overlay ，用于支持 UIKit 的半透明/blur 可以采样到 Skia 的内容的实验性 API ：

所以这个问题实际上的本质不是圆角，比如我把showModalBottomSheet背景改成红色，此时你可以看到键盘是可以采集到背景色的，甚至我把Container也改成红色，你也看不出来异常：

所以问题更多出现在透明色上，随着showModalBottomSheet弹出并带有透明色的时候，由于 Flutter 认为被键盘这挡住的下层 Widget 并不需要绘制，所以导致系统键盘采集不到对应的像素点，从而出现了一开始的黑色背景。

所以其实这个 Bug 如果想临时解决，只需要在Info.plist里配置UIDesignRequiresCompatibility = YES就可以了，只是此时 App UI 会是 iOS 18 的风格：

如果再对比抖音和 Github App ，就可以看到 iOS 26 新键盘风格对于整体应用的风格影响还是挺大的，所以不少 App 目前会选择通过关闭适配拖延时间。

那为什么会说，这个 Bug 会导致整个底层生态的重构？因为 iOS 26 改变了“系统键盘会完全遮挡 App 内容”这一长期不变的底层假设，而 Flutter 的渲染 / 布局 / Insets / 事件系统，几乎全都建立在旧假设之上，这套逻辑几乎渗透在：

RenderObject的layout
Scaffold/BottomSheet/Navigator
MediaQuery
TextInputPlugin
Engine 中的 view hierarchy
···

也就是如果想完全适配这个新场景（多层嵌套下还提供键盘场景的透明支持），一旦需要完全支持“键盘下内容需要绘制”，就要系统性重构多个核心层，例如

：

Framework 层（Dart）

MediaQuery.viewInsets
- 现在代表“不可见区域”
- 未来要不要拆成多个：coveredInsets、obscuredInsets、visualInsets
Scaffold / BottomSheet
- 是否仍然自动 resize？
- 还是只做布局、不做裁剪？
Clip 行为
- 现在大量 widget 默认不 clip