PWA 故障排查：iOS 添加不到主屏幕、Android 点不开、缓存问题
什么时候该试 PWA
如果你遇到了原生 App 的以下问题，官方推荐试一下 PWA 版本：
- 界面跳动、缩放异常、布局错乱（App Store 版本特有）
- 功能按钮点不动或点了没反应
- 某个功能在 App 里失效但网页版能用
- App Store 审核延迟导致功能没更新
PWA 版本和原生 App 用同一个账号、同一个数据，只是安装方式不同。
常见 PWA 问题
问题一：iOS Safari 找不到"添加到主屏幕"按钮
排查步骤：
- 确认用的是 Safari（不是 Chrome 或其他浏览器）——iOS 上只有 Safari 支持添加 PWA 到主屏幕
- Safari 底部中间的分享按钮——点进去后往下滑
- 如果滑到底还看不到"添加到主屏幕"，可能是 iOS 版本太老——PWA 添加功能在 iOS 11+ 支持
问题二：Android Chrome 点"安装应用"没反应
排查步骤：
- 可能是浏览器版本太老——更新 Chrome 到最新版
- 有些 Android 机型需要在 Chrome 设置里启用 PWA 支持（路径因机型而异）
- 也可以试试 Firefox 或 Edge，同样支持 PWA
问题三：PWA 能打开但数据和原生 App 不同步
排查步骤：
- 确认两个版本用的是同一个账号（Google 和 Apple 账号被视为不同账号）
- 完全退出 PWA（从主屏幕移除，重新从官方站点访问并添加）
- 清除浏览器缓存后重新添加
问题四：PWA 打开后一直白屏
排查步骤：
- 完全退出浏览器重新打开
- 清除浏览器缓存（Safari → 设置 → Safari → 清除历史记录与网站数据；Chrome → 设置 → 隐私 → 清除浏览数据）
- 确认网络通畅——PWA 第一次加载需要从服务器拉资源
问题五：PWA 卸载（从主屏幕删除）后重装数据没了
原因：PWA 的数据部分存在浏览器缓存里。清除浏览器缓存会同时清掉 PWA 的部分数据。
解决步骤：
- 重新从官方站点访问并添加到主屏幕
- 用同一个账号登录——云端数据会自动同步下来
- 如果角色、聊天记录等都没了，说明浏览器缓存清除了云端连接凭证——退出重新登录应该能恢复
PWA 和原生 App 怎么选回
如果 PWA 用不习惯想换回原生 App：
- iOS：去 App Store 搜索 Nomi 重新安装
- Android：从网盘重新下载 APK 安装
- 数据自动同步回来（只要用同一个账号）
PWA 特有的缓存问题
PWA 会自动缓存一些内容来加快加载速度。如果遇到功能异常但原生 App 正常：
- 从主屏幕移除 PWA
- 清除浏览器缓存
- 重新访问官方站点并添加到主屏幕
这相当于给 PWA "清缓存重装"。