专注小程序 / APP 开发,用代码改变生活

获取方案
全国分站 主站首页 北京分站 石家庄分站 唐山分站 保定分站 廊坊分站 沧州分站 郑州分站 邯郸分站

微信小程序登录态设计:从 code 到 session 的完整链路

小程序开发 2026-11-16 15 阅读 0 点赞 原创

很多开发者第一次写微信小程序登录时,会习惯性地把 wx.login 拿到的 code 当成用户身份凭证。跑通 demo 没问题,一旦用户量上来、多端共存,问题就暴露了。这篇聊聊登录态到底该怎么设计,以及从 code 到 session 的完整链路。

微信小程序登录态设计:从 code 到 session 的完整链路

先理清三个东西的身份

  • code:一次性凭证,5 分钟有效,用完即废,只能换一次。
  • openid:用户在当前小程序内的唯一标识,同一用户在不同小程序里不同。
  • session_key:会话密钥,用于解密敏感数据(如手机号、加密用户信息),绝对不能下发到前端。

关键认知:code 不是身份,它只是换取身份的敲门砖。真正的身份是服务端持有的 openid,而前端只应该拿到一个自己签发的 token。

标准链路:code 换 session

前端调用 wx.login 拿到 code,立刻发给自己的后端,由后端去请求微信接口:

// 服务端:Node.js 示例
const axios = require('axios');

async function login(code) {
  const url = 'https://api.weixin.qq.com/sns/jscode2session';
  const { data } = await axios.get(url, {
    params: {
      appid: process.env.APPID,
      secret: process.env.SECRET,
      js_code: code,
      grant_type: 'authorization_code'
    }
  });

  if (data.errcode) {
    throw new Error(`wechat error: ${data.errcode}`);
  }

  const { openid, session_key, unionid } = data;
  // 生成自己的 token,session_key 只留在服务端
  const token = signToken({ openid, unionid });
  await redis.set(`session:${openid}`, session_key, 'EX', 7200);
  return { token };
}

前端拿到 token 后存进 wx.setStorageSync,后续请求带上它即可。注意 session_key 一定不要返回给前端,它一旦泄露,攻击者可以伪造解密结果。

token 的续期与失效处理

微信的 session_key 会过期,用户也可能长时间不打开小程序。建议 token 自己设一个较长的有效期(比如 7 天),并在服务端维护 session 的刷新逻辑:

  • 前端请求返回 401 时,静默调用 wx.login 重新换取 token,然后重放原请求。
  • 服务端在 token 快过期时,可以通过 wx.checkSession 判断前端会话是否仍有效,避免频繁重登。
  • 退出登录时,前端清 token,服务端删 session 记录,双端一致。

一个常见的错误是只在启动时登录一次,之后再也不管 token 过期。用户用了一周后回来,所有请求全部失败,体验极差。把重登逻辑封装进请求拦截器,是更稳妥的做法。

云开发场景下的简化

如果用的是微信云开发,登录链路可以大幅简化。云函数里直接调用 cloud.getWXContext() 就能拿到 OPENID,不需要自己维护 code2Session:

// 云函数
exports.main = async (event, context) => {
  const { OPENID, UNIONID } = cloud.getWXContext();
  // 直接以 OPENID 作为用户主键
  return { openid: OPENID };
};

这时候前端甚至不需要显式登录,只要调用云函数,身份就是可信的。但要注意:云开发的 openid 只在云函数调用链里可信,如果你有自己的独立后端,仍然需要一套 token 机制来打通。

几个容易忽略的细节

  • unionid 的获取条件:同一开放平台账号下绑定了多个应用才会有 unionid,单小程序场景下可能拿不到,别把它当必填字段。
  • code 只能用一次:前端如果并发发起两次登录,第二次会失败,做好防抖。
  • 不要把 openid 当密码用:openid 可以出现在日志、埋点里,它不是秘密,但也不能作为鉴权凭证直接信任前端传来的值。
  • 敏感数据解密在服务端做:手机号、加密信息一律后端解密,前端只传密文。
登录态设计的核心原则只有一条:前端只持有自己签发的、可撤销的凭证,微信侧的密钥永远留在服务端。

把这套链路跑顺之后,后面做用户体系、多端打通、私域沉淀都会轻松很多。登录是小程序的地基,值得多花半天时间把它做扎实。

一个人也能做出微信小程序定制微信小程序:从需求到上线的完整路径

评论 (0)

还没有评论,快来抢沙发吧~

好想法,值得被认真交付

从小程序、APP 到全栈网站,一站式把想法变成可落地的产品

微信咨询

微信扫码,直接沟通需求