微信小程序静默登录偶发失败:我把 code 单次消费、登录锁和 token 刷新补齐了
一次 code 被并发重复换取 session_key 的报错,让我重新梳理小程序静默登录:一次性凭证、互斥登录、无感刷新,缺一不可。

作者
ZHOUYI
前段时间小程序里出现了一个很怪的偶发问题:用户进页面后静默登录失败,接口里偶尔报 code 已被使用或无效。最初以为是网络抖动,后来发现页面一打开就有多个请求同时判断登录态,导致同一个 wx.login 拿到的 code 被并发发给后端,重复换取 session_key。
把 code 当成一次性凭证
微信返回的 code 不是普通参数,而是短时效、一次性票据。前端不能在同一个 code 上反复重试,后端也不能把换取失败简单归因于用户网络。我的做法是:前端每次登录前先重新获取 code,后端拿到 code 后立即消费,并用 Redis 或数据库记录防止重复处理。
- wx.login 后只触发一次登录请求,失败后重新获取 code 再试
- 后端对 code 做单次消费标记,重复请求直接拒绝
- 换取失败返回明确错误码,避免前端拿旧 code 继续重试
登录流程要有互斥锁
并发是另一个坑。多个组件同时看到本地没有 token,就会同时发起登录。前端我做了单飞:同一个时间只保留一个登录 Promise,后续调用复用结果。后端再按用户维度加一个短锁,避免同一用户在极短时间内创建多个会话。锁的过期时间要短,防止异常时把正常登录卡住。
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 刷新做成闭环。涉及微信接口字段和能力边界,仍以官方文档为准。