Safari 17 无痕模式 setItem 直接报错 本地存储怎么兜底

客服工作台在 Safari 17 无痕窗口里打开直接白屏,控制台报 QuotaExceededError: The quota has been exceeded,指向初始化时第一次 localStorage.setItem。

第一反应是无痕模式不给写。查了才知道 Safari 给无痕窗口的配额是 0,setItem 任何键都抛,getItem 不报错、返回 null,所以读的那段代码静默通过,写的那段把整个初始化流程打断了。

试过只用 try/catch 包住写入,页面能开,但后续读到的 token 一直是 null,用户每次刷新都要重新登录。也试过看 userAgent 里有没有无痕标记,Safari 17 的 UA 和普通窗口完全一样,判不出来。

最终封了一层存储适配,模块加载时先探测:写入 __probe 再删掉,抛异常就把 usable 置 false。之后所有读写都走这层,写失败自动降级到内存 Map,读也优先走同一份数据,保证同一会话内前后一致。

Map 刷新就丢,所以登录态另外写了一份到 sessionStorage,同样受限就退回内存。用户能感知的差别只剩刷新要重登,不再白屏。业务里 7 处 localStorage 调用点全部换成这层的 get 和 set。

确认口径:Safari 17 无痕、iOS 17 无痕、Chrome 120 普通窗口三种环境打开工作台,前两种不白屏、功能可用、刷新需重登;第三种刷新保持登录;普通窗口写入量 12KB,远小于配额上限。

const mem = new Map();
let usable = false;
try {
  localStorage.setItem('__probe', '1');
  localStorage.removeItem('__probe');
  usable = true;
} catch (e) {
  usable = false;
}
export function get(k) {
  return usable ? localStorage.getItem(k) : mem.get(k) ?? null;
}
export function set(k, v) {
  if (usable) {
    try { localStorage.setItem(k, v); return; }
    catch (e) { usable = false; }
  }
  mem.set(k, v);
}

您可以还会对下面的文章感兴趣: