Flutter应用DeepLink异常求助：iOS跳转至preview.page.link页面

可能原因及修复步骤 #

1. 检查Universal Links配置 #

• 确认apple-app-site-association文件已正确部署到域名根目录或.well-known目录，文件内容需包含正确的App ID和路径关联，示例格式：

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "你的TeamID.你的BundleID",
        "paths": ["*"]
      }
    ]
  }
}

• 验证文件可通过https://你的域名.com/apple-app-site-association或https://你的域名.com/.well-known/apple-app-site-association访问，且返回的Content-Type为application/json。

2. 检查Xcode项目配置 #

• 打开Xcode项目的Signing & Capabilities标签，确认已添加Associated Domains，格式为applinks:你的域名.com（不要带http/https前缀）。
• 确保项目的Bundle Identifier和Team ID与apple-app-site-association文件中的信息完全匹配。

3. 修正Flutter端DeepLink处理逻辑 #

• 若使用uni_links或url_launcher插件，需确保直接解析原始跳转URL，避免被中转页拦截。示例代码（基于uni_links）：

import 'package:uni_links/uni_links.dart';
import 'package:flutter/material.dart';

Future<void> initDeepLinks(BuildContext context) async {
  // 处理启动时的初始链接
  final initialLink = await getInitialLink();
  if (initialLink != null) _navigateToTargetPage(context, initialLink);

  // 处理后续的链接跳转
  linkStream.listen((String? link) {
    if (link != null) _navigateToTargetPage(context, link);
  });
}

void _navigateToTargetPage(BuildContext context, String link) {
  // 过滤中转链接，直接处理目标路径
  if (link.startsWith('https://你的域名.com/')) {
    final path = link.replaceAll('https://你的域名.com', '');
    Navigator.pushNamed(context, path);
  }
}

4. 排查聊天应用的链接预处理 #

• 部分聊天应用会自动生成preview.page.link这类中转链接，需确认聊天应用是否支持直接跳转你的App的Universal Link，或调整链接生成方式避免被中转。

5. 测试验证 #

• 用命令行在iOS模拟器测试：xcrun simctl openurl booted "https://你的域名.com/目标路径"，确认是否直接跳转至目标页面。
• 清除App和聊天应用的缓存后重新测试，排除缓存导致的异常。

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