嗨，我完全理解你的痛点——现有大量弹窗要逐个加状态管理记录确实太繁琐了，结合你使用go_router的场景，我给你分享两个实用的解决方案：

一、自动检测弹窗的轻量实现方案 #

Flutter本身没有全局弹窗监听的原生API，但我们可以通过封装弹窗组件+全局追踪单例的方式，用GlobalKey自动识别并记录弹窗的打开/关闭状态，不需要大规模修改现有代码：

1. 实现全局弹窗追踪单例 #

先写一个单例类来管理所有弹窗的状态，负责记录和移除弹窗信息：

class DialogTracker {
  static final DialogTracker instance = DialogTracker._();
  DialogTracker._();

  // 用GlobalKey作为唯一标识，存储弹窗名称/类型
  final Map<GlobalKey, String> _activeDialogs = {};

  // 记录打开的弹窗
  void recordOpenedDialog(GlobalKey key, String dialogTag) {
    _activeDialogs[key] = dialogTag;
    // 这里可以替换成你的埋点/日志上报逻辑
    print('弹窗已打开：$dialogTag，唯一标识：${key.hashCode}');
  }

  // 记录关闭的弹窗
  void recordClosedDialog(GlobalKey key) {
    final closedDialog = _activeDialogs.remove(key);
    if (closedDialog != null) {
      print('弹窗已关闭：$closedDialog');
    }
  }
}

2. 封装可追踪的弹窗组件 #

继承原生AlertDialog（或你常用的弹窗组件），在组件的生命周期里自动上报状态：

class TrackedDialog extends AlertDialog {
  final GlobalKey dialogKey;
  // 用来标识弹窗的名称/类型，比如"UserInfoDialog"
  final String dialogTag;

  TrackedDialog({
    super.key,
    required this.dialogKey,
    required this.dialogTag,
    super.title,
    super.content,
    super.actions,
  });

  @override
  void initState() {
    super.initState();
    // 弹窗初始化时上报打开状态
    DialogTracker.instance.recordOpenedDialog(dialogKey, dialogTag);
  }

  @override
  void dispose() {
    // 弹窗销毁时上报关闭状态
    DialogTracker.instance.recordClosedDialog(dialogKey);
    super.dispose();
  }
}

3. 替换现有弹窗使用 #

只需要把原来的AlertDialog替换成TrackedDialog，加上dialogKey和dialogTag即可，改动非常小：

// 创建唯一的GlobalKey
final userInfoDialogKey = GlobalKey();

// 打开弹窗
showDialog(
  context: context,
  builder: (context) => TrackedDialog(
    dialogKey: userInfoDialogKey,
    dialogTag: "UserInfoDialog",
    title: const Text("用户信息"),
    content: const Text("这是用户详情弹窗"),
    actions: [
      TextButton(
        onPressed: () => Navigator.pop(context),
        child: const Text("关闭")
      )
    ],
  ),
);

二、基于go_router的弹窗路由管理方案 #

如果你想把弹窗也纳入路由系统统一管理，go_router支持将弹窗作为“弹出式路由”处理，这样弹窗的打开/关闭会被路由系统自动追踪，和页面跳转的逻辑复用：

1. 定义弹窗路由 #

在go_router的路由表中，给弹窗单独定义子路由，用自定义Page来创建弹窗：

final router = GoRouter(
  routes: [
    GoRoute(
      path: "/home",
      builder: (context, state) => const HomePage(),
      // 定义弹窗子路由
      routes: [
        GoRoute(
          path: "user-info-dialog",
          pageBuilder: (context, state) => DialogPage(
            child: AlertDialog(
              title: const Text("用户信息"),
              content: const Text("这是通过路由打开的弹窗"),
              actions: [
                TextButton(
                  onPressed: () => context.pop(),
                  child: const Text("关闭")
                )
              ],
            ),
          ),
        ),
      ],
    ),
  ],
);

// 自定义DialogPage，用于创建弹窗路由
class DialogPage extends Page {
  final Widget child;

  const DialogPage({required this.child, super.key});

  @override
  Route createRoute(BuildContext context) {
    return DialogRoute(
      context: context,
      builder: (context) => child,
    );
  }
}

2. 通过路由打开/关闭弹窗 #

用go_router的导航方法打开弹窗，和页面跳转的方式完全一致：

// 打开弹窗
context.push("/home/user-info-dialog");

// 关闭弹窗（和关闭页面逻辑一样）
context.pop();

3. 追踪弹窗路由变化 #

你可以监听go_router的路由变化，来记录弹窗的打开/关闭状态，和页面跳转的追踪逻辑复用：

// 在初始化时添加路由监听
GoRouter.of(context).routerDelegate.addListener(() {
  final currentRoute = GoRouter.of(context).location;
  // 判断当前路由是否是弹窗路由
  if (currentRoute.contains("user-info-dialog")) {
    print("弹窗已打开：UserInfoDialog");
  } else {
    // 这里可以结合之前的路由记录，判断是否是从弹窗路由返回
    print("弹窗已关闭");
  }
});

这种方案的好处是，弹窗完全纳入路由系统管理，不需要额外的状态追踪逻辑，而且可以通过state.extra传递弹窗所需的数据，非常灵活。

备注：内容来源于stack exchange，提问作者Terry Windwalker