iOS 11.3主屏幕Web App丢失Local Storage问题求助

嘿，这个问题我之前帮好几个开发者排查过，iOS 11.3的那次更新确实给主屏幕Web App（就是用户添加到主屏幕的那种Web应用）的存储机制做了个关键调整，刚好踩中了你家应用的老逻辑。

问题到底出在哪？ #

苹果在iOS 11.3里改了主屏幕Web App的存储隔离策略：从主屏幕启动的Web App现在会使用独立的LocalStorage容器，不再和Safari浏览器共享存储。

这就导致了用户反馈的“丢失凭证”现象：

• 用户之前是在Safari里登录的，凭证存在了Safari的LocalStorage容器里
• 升级iOS 11.3后，从主屏幕启动应用时，用的是全新的专属存储容器，自然读不到之前存在Safari里的凭证
• 而你家应用的存储逻辑没改，还是默认依赖Safari和主屏幕App共享存储，所以就出现了“突然丢失”的情况——其实不是丢了，是存在另一个容器里了。

怎么解决？给你三个可行方案，按优先级排： #

1. 切换到sessionStorage + 静默登录（最适配iOS新特性） #

sessionStorage虽然是会话级存储，但iOS 11.3+的主屏幕Web App只要没被系统杀掉，会话存储会一直保留。配合以下逻辑：

• 应用启动时先检查sessionStorage里有没有有效凭证
• 如果没有，调用后端的静默登录接口（比如用用户之前留在Cookie里的会话标识，只要用户没手动登出，后端就能识别身份）
• 登录成功后把凭证存到sessionStorage，保证当前会话可用
• 再搭配Service Worker的后台同步功能，网络正常时自动刷新凭证，减少用户操作

2. 改用Cookie存储凭证 #

iOS 11.3+的主屏幕Web App是和Safari共享Cookie容器的（只要域名一致），所以把凭证存在Cookie里是个稳妥的办法：

• 设置合适的expires或max-age属性，让Cookie持久化
• 一定要加上HttpOnly和Secure属性，避免XSS攻击和明文传输
• 跨域场景的话，记得配置SameSite=Lax或SameSite=Strict，适配现代浏览器的安全策略

3. 引导用户在主屏幕App内重新登录一次（临时过渡方案） #

这是最快能缓解用户抱怨的办法：用户第一次从主屏幕启动时，新容器是空的，加个友好提示比如“为了给你更好的体验，请重新登录一次”，同时简化登录流程（比如一键获取验证码、指纹/面容登录），降低用户反感。等用户登录后，凭证就存在主屏幕App的专属容器里了，之后启动就不会再丢。

额外要注意的坑 #

• 别再指望主屏幕App和Safari共享LocalStorage了，这是iOS 11.3+的既定行为，苹果不会改回去
• 测试时一定要用真机或者iOS模拟器的主屏幕App模式，别直接用Safari测试，两者存储容器不一样
• 如果你的应用用了manifest.json，确保scope属性设置正确，它会影响存储容器的隔离范围

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