·更新于 2026年11月22日· 62 次浏览 微信小程序Node.jsRedisBUG解决工程实践

微信小程序静默登录偶发失败:我把 code 单次消费、登录锁和 token 刷新补齐了

一次 code 被并发重复换取 session_key 的报错,让我重新梳理小程序静默登录:一次性凭证、互斥登录、无感刷新,缺一不可。

微信小程序静默登录偶发失败:我把 code 单次消费、登录锁和 token 刷新补齐了 封面
ZHOUYI

作者

ZHOUYI

前段时间小程序里出现了一个很怪的偶发问题:用户进页面后静默登录失败,接口里偶尔报 code 已被使用或无效。最初以为是网络抖动,后来发现页面一打开就有多个请求同时判断登录态,导致同一个 wx.login 拿到的 code 被并发发给后端,重复换取 session_key。

把 code 当成一次性凭证

微信返回的 code 不是普通参数,而是短时效、一次性票据。前端不能在同一个 code 上反复重试,后端也不能把换取失败简单归因于用户网络。我的做法是:前端每次登录前先重新获取 code,后端拿到 code 后立即消费,并用 Redis 或数据库记录防止重复处理。

  1. wx.login 后只触发一次登录请求,失败后重新获取 code 再试
  2. 后端对 code 做单次消费标记,重复请求直接拒绝
  3. 换取失败返回明确错误码,避免前端拿旧 code 继续重试

登录流程要有互斥锁

并发是另一个坑。多个组件同时看到本地没有 token,就会同时发起登录。前端我做了单飞:同一个时间只保留一个登录 Promise,后续调用复用结果。后端再按用户维度加一个短锁,避免同一用户在极短时间内创建多个会话。锁的过期时间要短,防止异常时把正常登录卡住。

js
const loginTask = new Map();
async function silentLogin() {
  if (loginTask.has('main')) return loginTask.get('main');
  const task = (async () => {
    const { code } = await wx.login();
    return request('/auth/wx-login', { code });
  })().finally(() => loginTask.delete('main'));
  loginTask.set('main', task);
  return task;
}

token 刷新要无感且幂等

登录成功后,我不再拿 session_key 做业务鉴权,而是由服务端签发自己的 access token 和 refresh token。access token 短时效,业务请求遇到 401 时先走刷新,而不是立刻重新登录。多个请求同时 401 时,刷新也要单飞,避免刷新接口被并发打爆。刷新失败再清空本地态,重新执行 wx.login。

  • access token 过期时间短,降低泄露风险
  • refresh 接口需要幂等,并绑定设备或用户维度校验
  • 支付、下单等敏感操作前再次确认登录态有效

“会话稳定不是靠一次成功登录,而是把重试、并发、过期这些边界都收口成确定性流程。”

这套方案上线后,偶发登录失败基本消失。回头再看,关键不是某个神奇补丁,而是把一次性凭证、并发登录和 token 刷新做成闭环。涉及微信接口字段和能力边界,仍以官方文档为准。

Guestbook

留言

若这篇文章也曾停在你心上,留一行字吧,我会看的。

先确认一下邮箱

多这一步,是为了少些机器骚扰,也让我能更踏实地读每一条真人写下的字。验证码 10 分钟内有效;同一邮箱 60 秒内只能发一封。

本文留言

共 0 条已加载 0 条

这里还静悄悄的——愿意做第一个留下脚印的人吗?