很多开发者第一次写微信小程序登录时,会习惯性地把 wx.login 拿到的 code 当成用户身份凭证。跑通 demo 没问题,一旦用户量上来、多端共存,问题就暴露了。这篇聊聊登录态到底该怎么设计,以及从 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)
还没有评论,快来抢沙发吧~