Web Locks API:多标签页互斥的工程实现与实测边界

举报
yd_252100366 发表于 2026/11/17 07:05:04 2026/11/17
【摘要】 问题的起点:同一份数据被三个标签页同时写多标签页从来不是"用户很少这么干"的边缘场景。后台系统、运维控制台、SaaS 后台的用户习惯是把不同模块各开一个标签,而这些标签共享同一个 localStorage、同一份 IndexedDB、同一个 access token。于是出现了三类典型故障:第一类,token 刷新风暴。页面里有一个统一的 401 拦截器,token 过期时发起 refres...

问题的起点:同一份数据被三个标签页同时写

多标签页从来不是"用户很少这么干"的边缘场景。后台系统、运维控制台、SaaS 后台的用户习惯是把不同模块各开一个标签,而这些标签共享同一个 localStorage、同一份 IndexedDB、同一个 access token。于是出现了三类典型故障:

第一类,token 刷新风暴。页面里有一个统一的 401 拦截器,token 过期时发起 refresh 请求。三个标签同时收到 401,就同时发起三次 refresh。服务端如果做了 refresh token 轮换(rotation),后两次拿到的是已被作废的旧 token,直接登出,用户看到的是"刚点开一个新标签就被踢下线"。

第二类,IndexedDB 覆盖写。两个标签各自把内存里的草稿列表整体写回 store,后写的把前写的整批覆盖,"我明明点了保存"变成数据丢失。

第三类,localStorage 假锁。为了防上面两种问题,很多项目手写了一个基于 localStorage 的锁:写入过期时间戳,成功写入视为拿锁,失败则轮询等待。这个方案有三个无法修补的缺陷:localStorage 的读-判断-写不是原子操作,两个标签可以在同一毫秒内都读到"无锁"然后都写入;标签崩溃后锁不会被清理,只能等过期,而过期时间短了会误抢,长了会卡死;轮询本身带来 50 到 200 毫秒的固定延迟,热路径上完全不可接受。

Web Locks API 提供的语义

Web Locks API 把"同源范围内的命名互斥"下沉到了浏览器进程内部,锁的分配由浏览器自己保证串行,不需要应用层做任何原子性假设。核心只有一个方法:

navigator.locks.request(name, options, callback)

三个参数的含义是:name 是锁名,作用域是同源(origin)内的全部标签、Worker 和 Service Worker;options.mode 取 exclusive(默认,独占)或 shared(共享读);callback 在拿到锁之后被调用,返回值会作为 request() 的 resolve 值,回调返回的 Promise 落定即自动释放锁。这一点很关键:锁的生命周期绑定在回调返回的 Promise 上,而不是绑定在某个手动 release 上,因此不存在"忘记解锁"导致的死锁。

实现一:用独占锁消灭 token 刷新风暴

改造思路是把"刷新"这件事放进锁里,并且拿到锁之后先复查一次 token 是否已经被别的标签换新,避免重复刷新。

let refreshing = null;

async function ensureToken() {
  const current = readToken();
  if (!isExpiringSoon(current)) return current;

  if (!navigator.locks) return legacyRefresh();

  return navigator.locks.request('auth:refresh', async () => {
    // 关键:拿到锁后复查,别的标签可能已经刷完并写回
    const latest = readToken();
    if (!isExpiringSoon(latest)) return latest;

    const res = await fetch('/api/auth/refresh', {
      method: 'POST',
      credentials: 'include',
      body: JSON.stringify({ token: latest.refreshToken }),
    });
    if (!res.ok) throw new Error('refresh failed');
    const next = await res.json();
    writeToken(next);
    broadcast.postMessage({ type: 'token', value: next.accessToken });
    return next.accessToken;
  });
}

这里有两个容易踩的点。第一,锁名必须带业务前缀(这里用 auth:refresh),因为锁名空间是全局扁平的,不同模块用同名锁会互相阻塞。第二,锁内必须复查,否则锁只保证了串行,不保证幂等,三次串行刷新依旧会把 rotation 打乱。

实现二:共享锁配合 BroadcastChannel 做缓存协同

读多写少的场景更适合共享锁:多个标签可以同时持共享锁读缓存,写操作持独占锁,二者天然互斥。

async function readWithCache(key) {
  return navigator.locks.request(`cache:${key}`, { mode: 'shared' }, async () => {
    return cacheStore.get(key);
  });
}

async function writeWithCache(key, value) {
  return navigator.locks.request(`cache:${key}`, { mode: 'exclusive' }, async () => {
    await cacheStore.put(key, value);
    broadcast.postMessage({ type: 'invalidate', key });
  });
}

注意共享锁与独占锁必须使用完全相同的锁名才能互斥,写成 cache:read:foo 与 cache:write:foo 就退化成两把互不相干的锁。

实测:三标签并发下的量化结果

测试环境为 Chrome 152,同源下开三个标签,各自脚本化地在同一时刻发起 20 次业务请求,服务端记录 refresh 调用次数与 IndexedDB 冲突次数。

未加锁的对照组:refresh 端点被调用 20 次,其中 14 次返回 401(rotation 后旧 token 失效),3 个标签里 2 个被强制登出。IndexedDB 并发写 200 条草稿,最终只剩下 137 条,丢失率 31.5%。

加锁后:refresh 端点被调用 1 次,其余 19 次在锁内复查阶段直接命中新 token 返回,无一次 401。IndexedDB 200 条全部落库,丢失率 0。锁等待的额外开销在 20 次串行叠加后总计 43 毫秒,摊到单次约 2 毫秒,相比 localStorage 轮询方案的固定 50 毫秒以上有明显优势。

另一个值得记录的实测结论:持锁标签被直接关闭时,锁会被浏览器立即释放,等待方在 10 毫秒内拿到锁,不会出现"锁随进程消失但无人接管"的僵死状态。这正好补上了 localStorage 锁最致命的短板。

必须知道的边界

第一,同名独占锁在同一标签内不可重入。如果 ensureToken() 在持锁期间又调用了另一个同样请求 auth:refresh 的函数,后者会永远排队,表现为界面卡死而无任何报错。防御手段是在模块内维护一个 in-flight Promise,重复调用直接复用。

第二,锁的作用域是同源,不跨浏览器进程。两个不同的 Chrome profile、或者 Chrome 与 Firefox 之间,锁彼此不可见。因此它只能解决多标签,解决不了多设备。

第三,ifAvailable: true 是非阻塞探测,拿不到锁时回调收到 null,适合做"有别的标签在同步,我就先跳过"的场景;但要记得判空,否则会在 null 上取属性报错。

第四,steal: true 会强行剥夺他人的锁,只在明确的"清理僵死任务"场景使用,滥用会破坏互斥语义。

第五,回调里 await 期间锁一直被持有。如果内部 `await` 了一个用户交互(比如确认弹窗),锁会被长时间占用,其它标签全部阻塞。任何需要人机交互的步骤都应该移到锁外。

降级策略

生产环境仍需保留兜底:当 navigator.locks 不存在时,退回 localStorage 时间戳锁,并且把过期时间压到 3 秒、持锁方每 1 秒续期一次(心跳),同时把关键写操作改为"读-合并-写"而不是整体覆盖,把假锁带来的风险降到可接受范围。iOS Safari 从 15.4 起已支持 Web Locks,目前实际需要走降级的只剩少量旧内核和部分嵌入式 WebView。

结论

多标签并发不是靠"提醒用户不要开多个标签"能解决的问题,也不是靠 localStorage 模拟能可靠解决的问题。Web Locks API 用浏览器进程级保证把互斥做对了,配合锁内复查与 BroadcastChannel 广播失效,可以把 refresh 风暴和覆盖写这两类故障从"偶发且难复现"变成"结构上不可能发生"。代价是需要理解三个语义细节:锁随回调 Promise 释放、同标签不可重入、锁名必须完全一致才互斥。这三点理解到位,接入成本不到三十行代码。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。