AutoRoute 10.0.0版本中AutoTabsRouter.tabBar键盘异常关闭问题分析

在Flutter路由管理库AutoRoute从9.2.2升级到10.0.0版本后，开发者遇到了一个影响用户体验的关键问题：当使用AutoTabsRouter.tabBar构建的页面中包含文本输入框时，键盘会在打开后立即关闭。这个问题特别出现在嵌套路由结构中，且与路由页面的构造函数参数密切相关。

问题现象

开发者报告称，在升级到AutoRoute 10.0.0后，使用AutoTabsRouter.tabBar构建的页面中，任何TextFormField在获得焦点后，键盘会短暂出现然后立即消失。这种行为严重影响了需要文本输入的功能，如搜索框或表单填写。

问题根源

经过深入分析，发现问题与嵌套路由的构造函数参数有直接关系：

1. 当嵌套路由页面（作为标签页的子页面）没有任何构造函数参数时，功能表现正常
2. 一旦这些嵌套路由页面添加了构造函数参数（无论是位置参数、命名参数还是查询参数），就会出现键盘异常关闭的问题

这表明AutoRoute 10.0.0在处理带有参数的嵌套路由时，可能触发了不必要的页面重建，导致输入状态丢失。

技术细节

AutoTabsRouter.tabBar内部实现可能涉及以下机制：

1. 路由状态管理：当标签页切换时，AutoRoute需要维护多个页面的状态
2. 参数传递：带有参数的页面构造函数在路由切换时会被重新调用
3. 页面重建：参数变化会触发Widget树的重建，可能导致输入状态丢失

在10.0.0版本中，这种重建机制可能被过度触发，即使参数实际上没有变化。

临时解决方案

开发者提供了几种临时解决方案：

1. 降级到9.2.2版本：这是最直接的解决方案，但会失去新版本的功能
2. 使用AutoTabsRouter.builder替代tabBar：虽然解决了键盘问题，但会失去原生TabBar的集成功能
3. 避免在嵌套路由页面中使用构造函数参数：这限制了路由参数传递的能力

最佳实践建议

对于遇到类似问题的开发者，建议：

1. 仔细检查嵌套路由页面的构造函数，尽量减少不必要的参数
2. 考虑使用全局状态管理（如Provider或Riverpod）来替代路由参数传递
3. 对于必须使用参数的场景，可以尝试在页面内部缓存参数值，避免重建时丢失状态

后续版本更新

仓库维护者已在10.1.0版本中尝试修复此问题，但根据开发者反馈，问题在某些情况下仍然存在。建议开发者关注后续版本的更新说明，以获取官方修复。

这个问题提醒我们，在升级路由库版本时，需要特别注意嵌套路由和状态保持相关的功能测试，确保关键用户体验不受影响。