Flutter GetX控制器无法自动释放，onClose()不执行问题求助

问题根源 #

1. 在build()方法中调用Get.put(UnitsListController())是错误的：build会因页面重建多次执行，虽然Get.put会返回已存在实例，但Get.put默认permanent: true，控制器会被标记为永久存活，页面出栈后不会自动释放。
2. 手动调用Get.delete<UnitsListController>()无效，大概率是因为控制器被重复注册，或被其他GetX/GetBuilder组件持续引用。

具体解决方案 #

方案1：修正控制器注册逻辑，绑定页面生命周期 #

方式A：改用StatefulWidget，在initState中注册控制器

将页面改为StatefulWidget，在initState中一次性注册控制器，并设置permanent: false（页面销毁时自动释放）：

class UnitsList extends StatefulWidget {
  const UnitsList({Key? key}) : super(key: key);

  @override
  State<UnitsList> createState() => _UnitsListState();
}

class _UnitsListState extends State<UnitsList> {
  late UnitsListController controller;

  @override
  void initState() {
    super.initState();
    // 注册时指定permanent: false，绑定页面生命周期
    controller = Get.put(UnitsListController(), permanent: false);
  }

  @override
  void dispose() {
    // 可选：手动删除控制器，确保释放
    Get.delete<UnitsListController>();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    const horizontalPadding = EdgeInsets.symmetric(horizontal: 10);

    return Scaffold(
      appBar: AppBar(
        title: const Text('Units List'),
        centerTitle: true,
      ),
      body: Padding(
        padding: horizontalPadding,
        child: Obx(() => controller.isBusy.value
            ? const AppCircularIndicator()
            : SingleChildScrollView(
                child: Column(
                  children: [
                    GetBuilder<UnitsListController>(
                      builder: (_) => ListView.builder(
                        shrinkWrap: true,
                        physics: const NeverScrollableScrollPhysics(),
                        itemCount: controller.unitsList.length,
                        itemBuilder: (context, index) {
                          var item = controller.unitsList[index];
                          return GestureDetector(
                            onTap: () {
                              controller.selectedUnit = item;
                              print('${controller.selectedUnit!.rent}');
                              controller.onUnitTap();
                            },
                            child: const AppUnitCard(
                              // 卡片内容
                            ),
                          );
                        },
                      ),
                    ),
                  ],
                ),
              )),
      ),
    );
  }
}

方式B：使用GetView+路由绑定注册控制器

利用GetX的路由绑定机制，在路由配置时注册控制器，确保控制器与页面生命周期绑定：

1. 配置路由绑定：

// 在GetMaterialApp的getPages中添加路由
GetMaterialApp(
  getPages: [
    GetPage(
      name: '/unitsList',
      page: () => const UnitsList(),
      binding: BindingsBuilder(() {
        // lazyPut注册，fenix: false表示页面销毁后自动删除控制器
        Get.lazyPut<UnitsListController>(() => UnitsListController(), fenix: false);
      }),
    ),
    // 其他路由...
  ],
);

2. 页面改用GetView：

// GetView会自动获取绑定的控制器，无需手动调用Get.find()
class UnitsList extends GetView<UnitsListController> {
  const UnitsList({Key? key}) : super(key: key);

  @override
  Widget build(BuildContext context) {
    const horizontalPadding = EdgeInsets.symmetric(horizontal: 10);

    return Scaffold(
      appBar: AppBar(
        title: const Text('Units List'),
        centerTitle: true,
      ),
      body: Padding(
        padding: horizontalPadding,
        child: Obx(() => controller.isBusy.value
            ? const AppCircularIndicator()
            : SingleChildScrollView(
                child: Column(
                  children: [
                    GetBuilder<UnitsListController>(
                      builder: (_) => ListView.builder(
                        shrinkWrap: true,
                        physics: const NeverScrollableScrollPhysics(),
                        itemCount: controller.unitsList.length,
                        itemBuilder: (context, index) {
                          var item = controller.unitsList[index];
                          return GestureDetector(
                            onTap: () {
                              controller.selectedUnit = item;
                              print('${controller.selectedUnit!.rent}');
                              controller.onUnitTap();
                            },
                            child: const AppUnitCard(
                              // 卡片内容
                            ),
                          );
                        },
                      ),
                    ),
                  ],
                ),
              )),
      ),
    );
  }
}

方案2：清理全局引用 #

检查项目中是否有其他页面、全局工具类持有UnitsListController的实例引用，这类引用会阻止控制器被GC回收，导致onClose无法触发。

方案3：手动强制释放（特殊场景） #

如果上述方案无效，可在返回页面时手动触发释放：

• 在目标页面的返回逻辑中添加：

// 比如在跳转后的页面点击返回时
Get.back().then((_) {
  // force: true强制删除控制器
  Get.delete<UnitsListController>(force: true);
});

• 或在UnitsList页面添加WillPopScope拦截返回事件：

return WillPopScope(
  onWillPop: () async {
    Get.delete<UnitsListController>(force: true);
    return true;
  },
  child: Scaffold(
    // 页面内容...
  ),
);

验证方法 #

在UnitsListController的onClose方法中保留日志，返回页面后查看控制台是否打印onClose日志，也可以用print(Get.isRegistered<UnitsListController>())检查控制器是否已被删除。

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