Flutter iOS端DeepLink无法正常工作：无法获取邀请码并跳转登录页求助

我太懂你这种跨平台不一致的头疼了——Android端的DeepLink完美实现了预期功能，但iOS端折腾好几天还是只能打开闪屏页，根本拿不到邀请码也跳不到登录页预填。咱们一步步来排查和解决这个问题：

一、先补全iOS端的DeepLink基础配置（你的Info.plist内容不全，这大概率是核心问题） #

iOS的DeepLink分两种：自定义URL Scheme和Universal Links，你得先确保其中一种配置到位：

1. 配置自定义URL Scheme（适合测试和简单场景） #

在你的Info.plist里补充以下内容（替换成你的App专属Scheme，比如vezigo）：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>vezigo</string> <!-- 这里填你的自定义Scheme -->
        </array>
    </dict>
</array>

2. 如果用Universal Links（更正式的线上场景） #

除了在Info.plist里加：

<key>NSUserActivityTypes</key>
<array>
    <string>NSUserActivityTypeBrowsingWeb</string>
</array>

还要打开Xcode，进入你的项目Signing & Capabilities标签，添加Associated Domains，并填入applinks:你的域名.com（比如applinks:vezigo.com），同时要在你的域名服务器上配置apple-app-site-association文件。

二、简化DeepLink处理逻辑，去掉冗余的平台分支 #

你现在的代码里iOS用了MethodChannel，Android用了app_links，其实app_links库是支持iOS的，完全可以统一处理，没必要分开写，反而容易出错。修改main.dart里的DeepLink处理部分：

// 移除原来的Android/iOS分支逻辑，统一用app_links处理
final appLinks = AppLinks();
// 处理App冷启动时的DeepLink
final Uri? uri = await appLinks.getInitialLink();
if (uri != null && uri.path.contains('/referral/')) {
  initialReferralCode = uri.pathSegments.last;
  print("App opened with referral code: $initialReferralCode");
}

// 额外添加：处理App在前台时点击DeepLink的情况
// 先定义一个全局NavigatorKey，方便后续跳转
final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

appLinks.uriLinkStream.listen((Uri uri) {
  if (uri.path.contains('/referral/')) {
    final referralCode = uri.pathSegments.last;
    initialReferralCode = referralCode;
    print("Received referral code from active app: $referralCode");
    // 如果用户未登录，直接跳登录页
    if (!isLoggedIn) {
      navigatorKey.currentState?.pushReplacement(
        MaterialPageRoute(
          builder: (context) => LoginScreen(
            referralCode: referralCode,
            hideBackButton: true,
          ),
        ),
      );
    }
  }
});

然后把MaterialApp的navigatorKey赋值为上面定义的全局key：

return MaterialApp(
  navigatorKey: navigatorKey, // 加上这个
  debugShowCheckedModeBanner: false,
  // ... 其他原有配置
);

三、移除冗余的MethodChannel代码 #

你之前iOS端用的MethodChannel('referral_channel')如果没有对应的iOS原生代码实现，只会抛出异常，直接删掉这部分代码就行，现在用app_links完全能替代它的功能。

四、检查状态判断的时机 #

确保isLoggedIn和initialReferralCode的赋值都在runApp()之前完成，你现在的代码逻辑是对的，但可以加个日志确认：

print("isLoggedIn: $isLoggedIn, initialReferralCode: $initialReferralCode");

如果这两个值不符合预期，可能是SharedPreferences读取延迟，但你用了await应该没问题，实在不行可以把这部分逻辑包在FutureBuilder里处理。

五、正确测试iOS DeepLink的方式 #

iOS模拟器/真机不能直接输入链接测试，得用以下方法：

1. 模拟器：打开终端执行命令（替换成你的Scheme和邀请码）

   xcrun simctl openurl booted vezigo://referral/ABC123
   

2. 真机：把链接复制到Notes里，然后点击链接；或者用Safari打开链接。

最后再确认几个细节 #

• 确保app_links库的版本是最新的，避免兼容性问题
• 检查Xcode里的Info.plist有没有被其他配置覆盖
• 查看Xcode控制台的输出，看有没有DeepLink相关的错误日志

按照上面的步骤调整后，应该就能解决iOS端DeepLink只打开闪屏页的问题，成功获取邀请码并跳转登录页预填了。

内容来源于stack exchange