Android主屏幕PWA图标无法刷新？个人及全用户解决方案咨询

1. 拥有自己手机权限时的刷新方法 #

• 彻底清除Chrome站点数据：打开Chrome设置 → 站点设置 → 搜索你的PWA域名 → 点击「清除所有数据」（包含存储、缓存、权限等所有相关数据）
• 清理系统图标缓存：直接重启手机；或者长按主屏幕上的旧图标移除，重新添加PWA后再重启一次
• 验证资源正确性：用Chrome DevTools的「Application」面板，检查Manifest里的图标是否能正常加载（无404报错），确认图标尺寸符合要求（至少192x192、512x512），优先用PNG格式（部分Android版本对WebP支持不佳）
• 强制重新安装：在Chrome中打开PWA页面，点击菜单 → 「安装应用」选择覆盖现有安装；或者在DevTools的「Application > Manifest」里点击「Add to home screen」强制触发安装

2. 无用户权限时，推动所有用户刷新图标的方法 #

• 修改Manifest核心属性：更新name或short_name（比如临时加个小后缀再改回来），Android系统检测到Manifest关键变化后，会向用户推送应用更新提示，用户更新后会加载新图标
• 重命名图标文件：放弃用?v=x参数，直接修改图标文件名（比如icon.png改成icon-v2.png），同步更新Manifest和HTML meta标签里的图标路径，浏览器会识别为全新资源，不会读取旧缓存
• 配合Service Worker更新：在Service Worker的install事件中主动缓存新图标，activate事件里清理旧图标缓存；同时更新Service Worker的版本标识（比如修改文件名或添加版本注释），确保浏览器触发Service Worker更新，进而重新获取Manifest
• 站点内引导提示：在网站首页添加显眼公告，指导用户手动操作：「我们更新了应用图标，请先卸载主屏幕上的旧应用，再从浏览器重新安装即可看到新图标」

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