Flutter深度链接优化：点击返回按钮避免退出APP，跳转指定页面

问题本质 #

你当前用pushReplacement处理Deeplink路由，导致两个核心问题：

• 冷启动时，路由栈直接被替换成目标页面，没有主页面当返回节点，点返回就直接退应用
• 后台唤醒时，pushReplacement会把当前栈顶页面换掉，原来的路由栈丢了，没法回到之前的页面

修复方案 #

1. 修改冷启动的Deeplink处理逻辑（_initUriHandler） #

冷启动触发Deeplink时，先把主页面设为路由栈的根节点，再推入目标页面，这样返回时会先回到主页面：

Future<void> _initUriHandler() async {
  if (_initialUriLinkHandled) {
    return;
  }
  _initialUriLinkHandled = true;
  var navigator = Navigator.of(context);
  try {
    final initialUrl = await getInitialLink();
    if (initialUrl != null) {
      Uri uri = Uri.parse(initialUrl);
      var goToScreen = getScreen(uri);
      if (goToScreen == null) {
        // 解析不出对应页面就跳主页面
        navigator.pushReplacementNamed(AppRoutes.main);
        return;
      }
      // 清空现有路由，把主页面设为根，再推目标页面
      await navigator.pushNamedAndRemoveUntil(
        AppRoutes.main,
        (route) => false,
      );
      navigator.push(MaterialPageRoute(builder: (context) => goToScreen));
    } else {
      // 没有Deeplink就直接跳主页面
      navigator.pushReplacementNamed(AppRoutes.main);
    }
  } catch (e) {
    navigator.pushReplacementNamed(AppRoutes.main);
  }
}

2. 修改后台唤醒的Deeplink处理逻辑（_incomingLinkHandler） #

后台唤醒触发Deeplink时，用push替代pushReplacement，保留原来的路由栈，这样返回就能回到之前的页面：

_incomingLinkHandler() {
  if (kIsWeb) {
    return;
  }

  var navigator = Navigator.of(context);
  _streamSubscription = uriLinkStream.listen((Uri? uri) {
    var goToScreen = getScreen(uri);
    if (goToScreen == null) {
      return;
    }
    // 直接推新页面，不替换原有栈
    navigator.push(MaterialPageRoute(builder: (context) => goToScreen));
  }, onError: (err) => navigator.pushNamed(AppRoutes.main));
}

3. 可选：给目标页面加自定义返回逻辑 #

如果需要更精准控制返回行为，可以在目标页面用WillPopScope拦截返回事件：

class TargetScreen extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return WillPopScope(
      onWillPop: () async {
        // 能返回就正常回，不能就跳主页面
        if (Navigator.of(context).canPop()) {
          return true;
        } else {
          Navigator.of(context).pushReplacementNamed(AppRoutes.main);
          return false;
        }
      },
      child: Scaffold(
        // 页面内容
      ),
    );
  }
}

改完之后：

• 冷启动开Deeplink：路由栈是[主页面, 目标页面]，点返回先到主页面，再点才退应用
• 后台唤醒开Deeplink：在原有路由栈上加目标页面，返回直接回到之前的页面
• 解析失败或无Deeplink时，自动跳主页面

内容的提问来源于stack exchange，提问作者Ali Alhajji