Flutter真机（TestFlight）键盘遮挡SendInputField问题求助

核心问题分析 #

你的布局存在嵌套滚动组件冗余（SingleChildScrollView嵌套ListView.builder），导致Flutter在iOS真机上计算键盘弹出时的布局偏移异常——模拟器环境的布局计算宽松，未暴露问题，但TestFlight的release编译优化会放大这类逻辑漏洞，同时resizeToAvoidBottomInset: true的效果被嵌套结构抵消。

具体修复步骤 #

1. 移除冗余滚动嵌套 #

删掉_mainBody中多余的SingleChildScrollView和Stack，直接用ListView.builder作为滚动容器，因为ListView本身支持反向滚动，无需额外嵌套：

_mainBody(BuildContext context) {
  return Obx(
    () => Column(
      children: [
        Expanded(
          flex: 5,
          // 移除SingleChildScrollView和Stack，直接挂载ListView
          child: _buildList(),
        ),
        Obx(() => Visibility(
            visible: controller.isLoading.value,
            child: const CustomLoadingAPI())),
        _submitButton(context),
        SizedBox(height: Dimensions.heightSize)
      ],
    ),
  );
}

2. 给ListView添加反向滚动配置 #

把原来SingleChildScrollView的reverse: true移到ListView.builder中，实现消息列表底部滚动的效果：

_buildList() {
  return Obx(() => ListView.builder(
        controller: controller.scrollController,
        itemCount: controller.itemCount.value,
        shrinkWrap: true,
        reverse: true, // 新增：让最新消息固定在列表底部
        itemBuilder: (context, index) {
          return ChatMessageWidget(
            // ... 原有属性
            text: controller.messages.value[index].text,
            index: index);
        },
      ));
}

3. 动态适配键盘高度（可选兜底方案） #

如果上述调整后仍有问题，给底部输入区域包裹Padding，利用MediaQuery实时获取键盘高度调整内边距：

_mainBody(BuildContext context) {
  return Obx(
    () => Column(
      children: [
        Expanded(flex:5, child: _buildList()),
        Obx(() => Visibility(visible: controller.isLoading.value, child: const CustomLoadingAPI())),
        // 动态适配键盘高度，确保输入框不被遮挡
        Padding(
          padding: EdgeInsets.only(bottom: MediaQuery.of(context).viewInsets.bottom),
          child: _submitButton(context),
        ),
        SizedBox(height: Dimensions.heightSize)
      ],
    ),
  );
}

4. 确保SafeArea与resize属性配合生效 #

将body包裹在SafeArea中，同时保留Scaffold的resizeToAvoidBottomInset: true，避免iOS底部安全区干扰布局计算：

@override
Widget build(BuildContext context) {
  return WillPopScope(
    child: Scaffold(
      resizeToAvoidBottomInset: true,
      appBar: AppBarWidget(),
      // 用SafeArea包裹body，适配iOS系统安全区
      body: SafeArea(child: _mainBody(context)),
    ),
  );
}

额外排查点 #

• 检查SendInputField内部是否有固定高度、未适配的布局逻辑，确保它能随外部布局调整而移动；
• 确认TestFlight版本使用release模式编译（Flutter默认打包配置），避免模拟器与真机的编译差异导致布局异常。

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