已安装的PWA无法通过浏览器URL打开的问题排查求助

结合你的配置和Chrome的PWA唤起规则，以下是具体问题排查与修复方案：

一、.well-known/web-app-origin-association 文件问题 #

1. 必须设置正确的MIME类型
   Chrome要求该文件的响应头MIME类型为application/json，多数服务器默认不会自动识别这个无后缀文件的类型，需在服务器配置中手动添加（以Nginx为例）：

   location /.well-known/web-app-origin-association {
       default_type application/json;
   }
   

2. 确认文件可正常访问
   你配置的paths: ["/*"]已覆盖所有路径（包括带查询参数的URL），但需确保https://test.mysupersite.com/.well-known/web-app-origin-association能直接访问并返回正确的JSON内容。

二、manifest.webmanifest 配置修正 #

1. 完善 url_handlers 的路径规则
   当前仅配置origin的写法，Chrome匹配逻辑更倾向于明确的path声明，修改为：

   "url_handlers": [
     {
       "origin": "https://test.mysupersite.com",
       "path": "/*"
     },
     {
       "origin": "https://*.mysupersite.com",
       "path": "/*"
     }
   ]
   

2. 移除冗余的 related_applications 配置
   该配置用于关联原生应用或其他Web应用，对已安装PWA的URL唤起无帮助，反而可能干扰匹配逻辑，删除以下内容：

   "related_applications": [{
     "platform": "webapp",
     "url": "https://test.mysupersite.com/manifest.webmanifest"
   }],
   

3. 确认 start_url 可正常访问
   你的start_url为/?mode=standalone，需确保该URL能返回正常页面内容，避免影响PWA启动逻辑。

三、Chrome唤起规则的必要前提 #

1. 确保PWA为独立安装状态
   确认PWA是通过Chrome的「安装应用」流程添加到安卓应用列表的，而非仅添加到书签，可通过Chrome菜单→「安装MySuperSite」完成标准安装。
2. 重置Chrome应用唤起权限
   若之前点击过「不再提示」打开应用，Chrome会停止触发唤起提示：
   • 打开Chrome设置→隐私和安全→网站设置→权限→打开应用
   • 找到test.mysupersite.com，重置其权限
3. 检查Chrome版本
   确保安卓Chrome版本在89及以上，url_handlers和Origin Association功能在该版本后才稳定支持。

四、验证测试步骤 #

1. 打开Chrome地址栏输入chrome://web-app-internals/，找到你的PWA，查看「Origin Association」是否显示「Valid」，确认关联文件生效。
2. 在Chrome开发者工具→Application→Manifest，检查是否有加载报错，所有图标资源是否正常访问。
3. 清除Chrome缓存，重新安装PWA，先直接在地址栏输入测试URL，确认能唤起后再测试二维码场景。

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