Android端PWA共享托盘接收内容无查询参数问题排查

• 检查Web Manifest的MIME类型
  服务器必须返回Content-Type: application/manifest+json，否则Android无法正确解析share_target配置。可在服务器配置中添加对应头信息：

  • Nginx：add_header Content-Type application/manifest+json;
  • Apache：Header set Content-Type application/manifest+json

• 调整share_target的action路径
  若PWA是单页应用，action: "/"可能被前端路由拦截导致参数丢失。建议改为专门的处理页面，比如"/share-handler.html"，避免路由覆盖参数。

• 验证共享内容类型匹配
  测试不同类型的共享内容：

  • 纯文本：应填充bodyText参数
  • 网页链接：应填充dirtyurl、title、bodyText参数
    若仅分享纯文本，dirtyurl参数不会出现，属于正常情况。

• 检查PWA的安装状态与scope范围
  确保PWA是通过浏览器的「安装应用」功能完成安装，而非书签添加。同时确认manifest中的scope属性包含action路径，否则共享请求会被浏览器接管而非PWA处理。

• 排除前端路由干扰
  创建静态测试页面share-handler.html，内容如下：

  <script>
    document.write(window.location.href);
  </script>
  

  将manifest的action改为"/share-handler.html"，测试共享后查看该页面的URL，确认参数是否存在，以此排除前端路由的影响。

• 确认Android与浏览器版本
  Web Share Target API需Android Chrome 76及以上版本支持，确保设备使用的是兼容的浏览器版本。

内容的提问来源于stack exchange，提问作者Sammy I.