Flutter Deeplink安卓正常，iOS打开提示路由处理失败（go_router）求助

1. 修正apple-app-site-association配置 #

你的配置中同时存在paths（旧格式）和components（iOS 9+推荐格式），这可能导致路由解析冲突，先做如下调整：

• 移除冗余的paths字段，仅保留components用于路径匹配
• 若需同时支持带www和不带www的域名，需在苹果开发者后台的关联域名 entitlement 中添加两个条目（applinks:example.com和applinks:www.example.com），且两个域名的.well-known目录下都要放置修正后的配置文件

修正后的配置示例：

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appIDs": ["myTeamID.com.example.app"],
        "components": [
          {
            "/": "/*"
          }
        ]
      }
    ]
  },
  "webcredentials": {
    "apps": ["myTeamID.com.example.app"]
  }
}

注意：文件必须放在https://<你的域名>/.well-known/apple-app-site-association路径下，且访问时不能有HTTPS重定向。

2. 检查go_router的DeepLink处理逻辑 #

确保路由配置正确接收并解析DeepLink路径：

• 路由定义需明确path参数，避免模糊匹配导致解析失败
• 添加错误处理逻辑，打印路由错误信息定位问题

示例配置：

final router = GoRouter(
  initialLocation: '/',
  routes: [
    GoRoute(
      path: '/',
      builder: (context, state) => HomeScreen(),
    ),
    GoRoute(
      path: '/detail/:id',
      builder: (context, state) => DetailScreen(id: state.pathParameters['id']!),
    ),
  ],
  // 打印路由错误，方便排查
  errorBuilder: (context, state) {
    print('路由处理错误: ${state.error}');
    return ErrorScreen(error: state.error.toString());
  },
);

3. 确认iOS端DeepLink传递逻辑 #

检查AppDelegate.swift是否正确将Universal Links传递给Flutter：

import UIKit
import Flutter

@UIApplicationMain
@objc class AppDelegate: FlutterAppDelegate {
  override func application(
    _ application: UIApplication,
    continue userActivity: NSUserActivity,
    restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void
  ) -> Bool {
    return FlutterDeepLinkingPlugin.sharedInstance.continueUserActivity(userActivity)
  }
}

同时确保Info.plist中已开启DeepLink支持：

<key>FlutterDeepLinkingEnabled</key>
<true/>

4. 解决模拟器同时打开应用和网页的问题 #

模拟器中该问题属于正常现象，需调整测试方式：

• 不要直接在Safari地址栏输入链接，改为从Notes、邮件等应用中点击链接触发Universal Links
• 进入模拟器设置 > Safari > 通用 > 链接，确认你的域名已被允许使用关联链接

5. 验证关联域名与AppID一致性 #

检查Runner.entitlements中的关联域名是否与apple-app-site-association中的appIDs匹配：

<key>com.apple.developer.associated-domains</key>
<array>
  <string>applinks:example.com</string>
  <string>applinks:www.example.com</string>
</array>

确保appIDs中的TeamID（苹果开发者账号的Team ID）和BundleID完全正确，无拼写错误。

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