Flutter键盘弹出时自动跳转至登录页问题求助

问题概况 #

• 开发中的Flutter应用包含登录、注册、找回密码页面
• 点击任意页面的TextField唤起键盘时，应用会自动跳转到登录页，类似刚启动应用的状态
• 登录页内唤起键盘也会触发相同问题
• 已尝试但无效的方案：
  • 设置resizeToAvoidBottomInset: false
  • 使用SingleChildScrollView包裹页面
  • 更换TextField组件
  • 将SizedBox替换为Container

关键触发差异 #

• 使用Navigator.pushReplacement跳转登录页时，功能完全正常，键盘唤起无异常跳转
• 使用Navigator.push跳转登录页时，就会触发键盘唤起跳回登录页的问题

可能原因分析 #

这个问题核心大概率和路由栈重复叠加+布局变化触发的异常路由逻辑有关：

• Navigator.push会将登录页新增到路由栈顶部，如果初始启动时路由栈中已有登录页实例，后续再次push会导致栈中存在多个登录页。当键盘唤起触发页面布局resize时，可能触发了全局路由监听、状态管理中的异常判断逻辑，导致栈底的登录页被错误展示。
• Navigator.pushReplacement是替换当前路由，路由栈中始终只有一个登录页实例，避免了重复实例带来的冲突。

解决方案建议 #

1. 检查全局路由监听与守卫

   • 排查项目中是否存在NavigatorObserver之类的全局路由监听，确认是否在页面resize（键盘唤起时会触发）时错误执行了跳转登录页的逻辑
   • 检查自动登录状态判断的全局逻辑，比如是否误将页面布局变化当成未登录状态，强制触发路由跳转

2. 确保路由栈中登录页唯一

   • 统一使用pushReplacement跳转登录页，或者在跳转前清空路由栈，避免重复添加：

     // 示例：清空所有路由并跳转登录页
     Navigator.of(context).pushAndRemoveUntil(
       MaterialPageRoute(builder: (context) => LoginPage()),
       (route) => false,
     );
     

3. 排查状态管理逻辑

   • 检查使用的全局状态管理工具（如Provider、Bloc等），确认是否在键盘唤起时状态发生异常变更，进而触发路由跳转
   • 调整登录状态监听逻辑，确保仅在应用启动、用户主动操作（如退出登录）时触发跳转，而非页面布局变化时

4. 最小化复现定位问题

   • 创建一个极简测试项目，只保留登录、注册页和基础路由，逐步添加原有项目的业务逻辑，逐一排查是哪部分代码导致的冲突

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