PWA开发问题：如何在manifest.json中配置动态start_url？

核心结论 #

• start_url 不属于W3C manifest规范的强制必填字段，但安卓端存在兼容性问题：原生Chrome浏览器缺失该字段时会默认取当前页面完整路径（含查询参数）作为启动地址，不会影响安装弹窗触发；但国内多数定制安卓浏览器（如小米浏览器、UC浏览器、微信内置浏览器等）的PWA安装校验逻辑会把start_url作为必填校验项，缺失后会直接拦截安装弹窗，不推荐直接删除该字段。

适配带查询参数的两种可行方案 #

方案1：保留用户访问时的动态查询参数 #

直接将start_url设置为相对路径./即可，浏览器会自动继承用户首次访问站点时的完整路径（包含所有原有查询参数），不会强制覆盖为根路径。
示例配置：

{
  "start_url": "./",
  "scope": "."
}

该方案已经过线上多款PWA验证，安卓、iOS端添加到主屏幕后均能正常保留访问时的查询参数，全平台安装触发逻辑无异常。

方案2：固定给桌面启动的PWA追加指定查询参数 #

如果需要统一给所有从桌面启动的PWA添加标识类参数，可以直接把参数拼接进start_url字段，业务侧的动态参数也可以正常追加不会被覆盖：
示例配置：

{
  "start_url": "/?utm_source=pwa_homescreen",
  "scope": "/"
}

内容的提问来源于stack exchange，提问作者Why u do dis