Flutter iOS深度链接失效求助：配置后无法唤起应用

一、先理清两种深度链接机制的区别 #

你当前混用了自定义URL Scheme（myappname://格式）和Universal Links（applinks:关联域名），建议分开排查：

1. 自定义URL Scheme 无法唤起App的排查 #

你的Info.plist配置存在一处关键错误：

• 将CFBundleTypeRole的值从Editor改为Viewer——你的App是接收链接的一方，而非内容编辑角色。修正后的配置：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Viewer</string>
        <key>CFBundleURLName</key>
        <string>mywebsite</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myappname</string>
        </array>
    </dict>
</array>

• 直接在模拟器Safari地址栏输入myappname://mywebsite，测试能否唤起App：
  • 若无法唤起，检查XcodeBuild Settings中的Bundle Identifier是否与Info.plist一致，且应用使用开发者证书签名（Debug模式需开启自动签名并选择对应开发者账号）。
  • Flutter端需配置链接监听：比如用uni_links包，在main函数中添加监听逻辑，确保能捕获传入的链接。

2. Universal Links 服务器未收到请求的排查 #

你配置了applinks:mywebsite?mode=developer但服务器无请求，可能原因如下：

• HTTPS强制要求：即使本地开发，Apple要求Universal Links的服务器必须提供HTTPS服务（localhost除外）。若自定义域名通过hosts指向本地，需给本地服务配置自签名HTTPS证书，或用ngrok等工具将本地服务暴露为HTTPS地址，否则Safari不会发送apple-app-site-association请求。
• 文件格式与内容正确性：确保服务器根目录下的.well-known/apple-app-site-association文件（无后缀）格式正确，内容需包含你的Team ID和Bundle ID：

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

Team ID可在Apple开发者账号的Membership页面查看，Bundle ID是Xcode中应用的标识。

• 开发模式缓存问题：iOS模拟器会缓存Universal Links配置，需执行以下操作重置：
  1. 卸载模拟器中的App。
  2. 进入模拟器设置 > Safari浏览器 > 清除历史记录与网站数据。
  3. 重启模拟器，重新安装App。
• 关联域名配置验证：在Xcode的Signing & Capabilities中，确认Associated Domains已开启，且添加的applinks:mywebsite?mode=developer拼写正确（无空格、域名准确）。

二、重定向逻辑优化建议 #

若目标是用自定义URL Scheme唤起App，需注意：

• 避免页面加载时自动重定向，可添加"打开App"按钮让用户主动点击触发myappname://mywebsite链接——部分浏览器会拦截自动跳转的自定义Scheme。

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