如何配置apple-app-site-association仅跳转含特定URL查询参数的链接？

你当前的配置之所以会匹配所有链接，是因为没明确限定路径规则——就算没有modal=CreatePassword参数，系统也会默认匹配根路径下的所有链接。要实现只跳转带指定参数的链接，得调整components里的规则，同时明确路径和参数的双重要求。

正确的配置示例如下：

"applinks": {
    "details": [
        {
            "appIDs": ["com.app"],
            "components": [
                {
                    "/": "/",
                    "?": {
                        "modal": "CreatePassword"
                    }
                }
            ]
        }
    ]
}

配置关键点说明 #

• 添加"/": "/"：明确限定仅匹配网站的根路径链接，避免匹配其他子路径的链接
• "?"部分的规则：要求链接必须携带modal=CreatePassword这个查询参数，只有同时满足路径和参数条件的链接，才会触发App跳转

额外注意事项 #

• 确保配置文件的JSON格式完全正确，没有语法错误（比如引号、逗号的使用）
• 配置文件需要部署在网站的.well-known目录下（路径为https://www.example.com/.well-known/apple-app-site-association），或者直接放在网站根目录
• 测试前建议清除Safari缓存，或者使用未测试过该链接的设备，避免旧配置的缓存影响测试结果
• 可以使用苹果官方的App Search API验证工具检查配置是否符合要求

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