iOS中Deep Linking问题：未安装App时无法跳转至App Store（Flutter）

一、先排查Web服务器端配置（核心问题点） #

未安装App时，点击Universal Links会直接访问你的Web服务器，出现404说明服务器对应路径没有有效响应，重点检查：

• 确认Deep Link对应的URL路径（比如/product/123）在服务器上存在，或配置了跳转逻辑。如果这个路径本身没有对应的页面，浏览器必然返回404。你需要给该路径设置一个引导页面，通过meta标签或JS跳转到App Store应用页面，至少要有下载引导内容。
• 检查服务器HTTPS配置：虽然已安装时跳转正常说明HTTPS基本有效，但如果证书过期、域名不匹配，也可能导致异常（不过404更偏向路径问题）。
• 顺带核对apple-app-site-association文件：已安装时能正常跳转，说明苹果已经验证通过该文件的关联配置，但可以再确认paths字段是否包含你使用的Deep Link路径（比如"/product/*"这类通配符是否正确）。

二、核对App Store Connect配置 #

• 确认App ID的Associated Domains功能已开启，且添加的applinks:yourdomain.com域名与实际使用的完全一致（注意裸域名和带www的区别）。已安装时跳转正常说明这部分没问题，但可以再核对一遍避免拼写错误。
• 验证App Store跳转链接有效性：直接在浏览器打开你的App Store链接（比如itms-apps://itunes.apple.com/app/id123456789），看是否能正常跳转到应用详情页。

三、快速区分问题归属 #

• 已安装App时跳转完全正常 → 排除apple-app-site-association和App端设置的问题。因为苹果只有在验证文件有效、App的Associated Domains配置正确的前提下，才会触发App跳转，这说明这两部分逻辑是正常的。
• 未安装时404 → 问题几乎肯定在Web服务器。因为未安装时系统不会处理Universal Links关联，直接将链接交给浏览器访问，404是服务器返回的，和App本身无关。

四、验证测试步骤 #

• 直接在浏览器输入你的Deep Link URL，看是否返回404。如果是，立刻定位到服务器路径配置问题，需要给该路径添加跳转页面。
• 新建一个测试路径（比如/test-deep-link），在服务器上配置好App Store跳转逻辑，用这个路径生成Universal Links测试。如果测试链接能正常引导到App Store，说明原Deep Link路径的服务器配置有问题。

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