Flutter iOS端应用被杀后台时Deep Link无法正常跳转问题

一、先确认iOS原生配置是否到位 #

• 检查Info.plist中的CFBundleURLTypes，确保URL Schemes正确配置，且与你的Deep Link前缀匹配
• 如果使用Universal Links，确认Associated Domains已添加（格式为applinks:your-domain.com），且服务器上的apple-app-site-association文件配置正确（包含你的App ID和路径规则）
• 重点检查iOS 13+的SceneDelegate.swift（旧项目用AppDelegate.swift），确保Deep Link回调被正确处理：

  // SceneDelegate.swift 示例
  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      if let urlContext = connectionOptions.urlContexts.first {
          let url = urlContext.url.absoluteString
          // 将URL传递给Flutter，通过MethodChannel
          let channel = FlutterMethodChannel(name: "deep_link_channel", binaryMessenger: window?.rootViewController as! FlutterBinaryMessenger)
          channel.invokeMethod("handleDeepLink", arguments: url)
      }
      // 原有Flutter初始化代码...
  }
  
  // 处理后台唤起的情况
  func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
      if let urlContext = URLContexts.first {
          let url = urlContext.url.absoluteString
          let channel = FlutterMethodChannel(name: "deep_link_channel", binaryMessenger: window?.rootViewController as! FlutterBinaryMessenger)
          channel.invokeMethod("handleDeepLink", arguments: url)
      }
  }
  

二、Flutter端处理冷启动Deep Link #

冷启动时Flutter无法直接通过路由框架默认机制获取Deep Link，需手动捕获原生传递的参数：

// 在main函数或初始化页面中监听MethodChannel
final channel = MethodChannel('deep_link_channel');

@override
void initState() {
  super.initState();
  // 监听冷启动的Deep Link
  channel.setMethodCallHandler((call) async {
    if (call.method == 'handleDeepLink') {
      final url = call.arguments as String;
      // 解析URL并触发路由跳转
      if (url.contains('/oferta/')) {
        // auto_route示例
        await _appRouter.push(OfertaRoute(id: extractIdFromUrl(url)));
        // go_router示例
        // if (mounted) context.go(url);
      }
    }
  });
}

// 辅助方法：从URL中提取所需参数
String extractIdFromUrl(String url) {
  final parts = url.split('/');
  return parts[parts.indexOf('oferta') + 1];
}

三、路由框架的额外适配 #

• auto_route：在deepLinkBuilder匹配路径的基础上，冷启动时手动触发跳转，比如在runApp之后：

  runApp(MyApp());
  // 假设已通过MethodChannel获取到冷启动url
  if (coldStartUrl != null) {
    final deepLink = DeepLink.fromUri(Uri.parse(coldStartUrl));
    _appRouter.pushDeepLink(deepLink);
  }
  

• go_router：可以在GoRouter的initialLocation中动态设置冷启动URL，或监听生命周期状态处理：

  GoRouter(
    initialLocation: coldStartUrl ?? '/',
    routes: [/* 路由配置 */],
  )
  

四、关键测试步骤 #

• 完全退出应用（模拟器/真机上划关闭）
• 使用命令行测试：xcrun simctl openurl booted "your-scheme://oferta/test-id/123"
• 通过Xcode查看原生回调日志，确认URL是否被正确捕获

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