Flutter Getx返回页面时Controller状态丢失 GetBuilder重复调用问题

• 路由API使用错误：Get.offNamed(Routes.HOMESEARCH)的逻辑是销毁当前路由栈中目标路由上方的所有页面实例，重新初始化构建目标路由页，本质是新建页面而非返回已存在的上一页。原SearchHome页实例被销毁后，页面内的GetBuilder会随新页面重新执行初始化、build流程，所有未持久化的状态都会重置。
• 状态存储位置不合理：如果把需要保留的页面状态存在Widget的State层、而非GetxController中，页面重建时State会重新初始化，状态自然丢失。
• 传参逻辑不匹配：从新增页返回时用路由入参传值，但此时的SearchHome页是重新创建的新实例，如果没有在页面初始化阶段主动接收、处理Get.arguments参数，就拿不到之前提交的词汇数据。
• 回调时序有问题：原代码中await Get.toNamed(Routes.ADDNEWVOCAB)之后直接调用controller.addNewVocab()，没有等待接收新页面返回的数据，Controller状态还没更新就触发刷新，也会出现状态不符合预期的问题。

1. 修正返回逻辑，使用正确的路由API #

新增词汇页提交时，不需要重新导航到搜索页，直接关闭当前页、把提交的词汇数据作为返回值传给上一页即可，完全不会触发原搜索页重建：

ElevatedButton(
  onPressed: () {
    // 替换offNamed为Get.back，通过result字段传参
    Get.back(
      result: AddNewVocabModel(
        name: nameCtl.text,
        phonetic: phoneticCtl.text,
        ukPrononce: ukPrononce.text,
        usPrononce: usPrononce.text,
        position: position.text,
        description: description.text,
      ),
    );
  },
  child: const Text("Submit"),
)

如果业务场景必须用offNamed（比如需要清空之前的路由栈），要确保SearchHomeController是全局永久注册的，不会随页面销毁被回收，同时在SearchHome页的initState或者Controller的onInit生命周期里主动读取Get.arguments拿到传参，初始化页面状态。

2. 调整原页面的跳转回调，接收返回参数 #

把原来直接调用addNewVocab的逻辑，改成先接收新页面返回的数据，更新Controller状态后再刷新：

callback: () async {
  // 等待新页面关闭，接收返回的词汇数据
  final vocabResult = await Get.toNamed(Routes.ADDNEWVOCAB);
  if (vocabResult is AddNewVocabModel) {
    // 先把新词汇数据存入Controller的属性中持久化
    controller.currentNewVocab = vocabResult;
    controller.addNewVocab();
    // 针对id为'dic'的GetBuilder做定向刷新，避免无关组件重建
    controller.update(['dic']);
  }
},

3. 校验Controller的注册逻辑 #

不要在GetBuilder的init参数里临时创建Controller实例，推荐通过GetPage的binding属性提前注册，确保Controller生命周期和页面匹配：

// 路由配置示例
GetPage(
  name: Routes.HOMESEARCH,
  page: () => const SearchHomePage(),
  binding: BindingsBuilder(() {
    // 页面进入时创建Controller，页面退出时自动回收
    Get.put(SearchHomeController());
  }),
)

如果需要跨页面保留Controller状态，可以在注册时加permanent: true，但注意页面不需要时要手动调用Get.delete<SearchHomeController>()避免内存泄漏。

4. 状态全部下沉到Controller层 #

所有需要在页面重建后保留的状态（比如搜索历史、已加载的词汇列表、弹窗显示状态等），全部作为属性写在SearchHomeController里，不要存在Widget的State变量中。GetBuilder重建时只会重新执行builder方法，Controller实例只要没被回收，存储的属性值就不会丢失。

内容的提问来源于stack exchange，提问作者Cyrus the Great