iOS端点击链接无法打开已安装PWA问题求助

问题根源 #

iOS和Android对PWA的链接唤起逻辑存在差异：

• Android系统可通过manifest.json的配置直接识别域名归属的PWA，因此点击短信链接会直接打开已安装的应用；
• iOS则要求额外的**关联域（Associated Domains）**验证，确认域名与PWA的归属关系，否则会默认用Safari打开所有外部链接。另外你的manifest.json缺少几个iOS专属的关键配置项。

修复步骤 #

1. 配置苹果关联域与验证文件 #

• 登录苹果开发者后台，找到你的App ID，开启「Associated Domains」权限，添加两个关联域条目：
  • applinks:你的域名（示例：applinks:wsn.yourdomain.com）
  • webcredentials:你的域名
• 在网站根目录或.well-known目录下创建apple-app-site-association文件（不要添加.json后缀），内容示例：

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "你的团队ID.你的BundleID",
        "paths": ["*"]
      }
    ]
  },
  "webcredentials": {
    "apps": ["你的团队ID.你的BundleID"]
  }
}

说明：团队ID是苹果开发者账号的Team ID，BundleID是你在开发者后台注册的唯一标识（示例：com.yourcompany.wsn），服务器必须支持HTTPS协议。

2. 更新manifest.json #

在现有配置中补充以下iOS专属字段：

{
  // 保留原有所有配置
  "scope": "/",
  "apple-mobile-web-app-capable": "yes",
  "apple-mobile-web-app-status-bar-style": "default",
  "apple-mobile-web-app-title": "WSN"
}

• scope：明确PWA的作用范围，确保域名下所有链接都归属于该应用；
• apple-mobile-web-app-capable：标记这是可独立运行的PWA；
• apple-mobile-web-app-title：设置iOS主屏幕上的PWA显示名称。

3. 验证与测试 #

• 使用苹果官方的App Site Association验证工具检查配置文件是否有效；
• 删除iOS设备上已安装的PWA，重新从Safari添加到主屏幕；
• 发送测试短信，点击链接确认是否能直接唤起PWA。

额外注意事项 #

• 确保短信中的链接使用HTTPS协议，iOS不支持HTTP链接唤起PWA；
• 链接域名必须和PWA安装时的域名完全一致（避免混用www和非www域名）；
• iOS 15及以上版本对PWA唤起的兼容性更好，但关联域配置仍是必要条件。

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