Flutter路由pop返回后SearchDelegate结果组件被卸载问题

算力阿峰

2026-9-3

问题根本原因

这个行为是SearchDelegate内部未在公开文档说明的设计逻辑导致的，不属于框架bug：

showSearch弹出的搜索路由内部维护了两套独立的展示分支：搜索建议分支（对应buildSuggestions返回的组件）、搜索结果分支（对应buildResults返回的组件），默认初始进入搜索页时只会挂载建议分支。
只有当用户提交搜索词、显式触发结果展示时，搜索路由才会临时把结果分支挂载到组件树；只要搜索路由被新路由遮挡、失焦，或者搜索词发生变化，SearchDelegate会自动重置展示状态，直接卸载整个结果分支的组件树，切回建议分支。
从结果页push新路由时，搜索路由会进入后台失活状态，SearchDelegate监听到路由栈变化后立刻卸载结果分支，SearchResults对应的State自然被销毁，进入unmounted状态。等pop回搜索页时，除非重新触发搜索提交动作，否则不会重新挂载结果分支；就算重新挂载也是全新的组件实例，原来持有BuildContext的旧State已经被回收，直接访问就会触发异常。

可行解决方案

根据业务场景选择以下任意一种方案即可：

方案1：提升状态持有层级
不要把需要跨路由保留的状态、Context依赖放在buildResults返回的组件里，把状态提升到SearchDelegate子类层面持有，buildResults只负责渲染Delegate持有的状态。就算结果组件被销毁重建，状态也不会丢失，不会出现Context失效问题。
方案2：手动接管展示分支切换（推荐，最小改动）
不让SearchDelegate自动控制结果组件的挂载销毁，自行在buildSuggestions分支里判断是否需要展示结果，配合GlobalKey保证结果组件State不被重复销毁，参考实现：

class Search extends SearchDelegate {
  bool _showResults = false;
  final GlobalKey<SearchResultsState> _resultsKey = GlobalKey();

  @override
  Widget buildResults(BuildContext context) {
    _showResults = true;
    return SearchResults(key: _resultsKey);
  }

  @override
  Widget buildSuggestions(BuildContext context) {
    // 已提交搜索时，在建议分支直接渲染结果组件，避免被Delegate卸载
    if (_showResults) return SearchResults(key: _resultsKey);
    return const Text("Suggestions");
  }

  @override
  List<Widget> buildActions(BuildContext context) => [
    IconButton(
      icon: const Icon(Icons.clear),
      onPressed: () {
        query = '';
        _showResults = false;
      },
    )
  ];

  @override
  Widget buildLeading(BuildContext context) => IconButton(
    icon: const Icon(Icons.arrow_back),
    onPressed: () => close(context, null),
  );
}

方案3：通用容错处理
所有跨异步的Context、State操作，都先判断mounted属性再执行，这是Flutter异步场景的通用规范，不止适用于这个问题，可以避免所有组件销毁后异步回调触发的异常：

onPressed: () async {
  await Navigator.push<String>(
    context,
    MaterialPageRoute<String>(builder: (BuildContext context) => RouteA())
  );
  // 先判断组件是否挂载再执行后续逻辑
  if (!mounted) return;
  // 后续可安全使用context或者操作State
  print(mounted);
}

方案4：跳转前关闭搜索页
如果业务上不需要pop回搜索结果页，可以在push新路由前先调用close(context, null)关闭搜索路由，再跳转目标页，从根源上避免返回时组件不存在的问题。

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