微信小程序登录开发,从零到上线的完整指南
发布时间:11-15来源:微信小程序工具|微信小程序开发|微信小程序制作平台-龙图应用【XcxIP.com】
写微信小程序登录,最怕什么?不是代码写不出来,而是你根本不知道从哪一步开始。网上教程一堆,要么只讲前端调接口,要么只贴后端代码,前后端怎么串起来,没人说清楚。我见过太多人卡在这:前端 wx.login 拿到了 code,然后呢?发给谁?怎么换 openid?sessionkey 存哪?这些问题不搞清楚,你写出来的登录就是个半成品。今天这篇,就把微信小程序登录从零到上线这条路,掰开揉碎讲一遍,保证你能照着做出来。

先搞清楚微信登录到底在干什么。小程序的登录,本质上就是让你的服务器知道“这个用户是谁”。微信不直接给你用户信息,它给你一个临时凭证 code,有效期五分钟。你拿这个 code 去微信的接口换 openid 和 sessionkey。openid 是用户在你这个小程序里的唯一身份标识,sessionkey 是解密用户手机号等敏感信息的密钥。流程就三步:前端调 wx.login 拿 code,后端拿 code 换 openid,后端返回自定义登录态给前端。听起来简单,但坑全藏在细节里。
前端这边,wx.login 必须在用户点击登录按钮时调用,不能放在 onLoad 里自动执行。为什么?因为微信官方对用户隐私越来越严格,你悄咪咪登录,审核可能过不了。正确的做法是:页面渲染一个登录按钮,用户主动点击,触发 wx.login,拿到 code 后发给后端。这里有个细节,code 只能用一次,换完就失效,所以拿到 code 要立刻发请求,不能存着等下次用。很多人在这里踩坑,把 code 存到全局变量里,结果第二次用发现失效了,报错还找不到原因。
后端拿到 code 之后,要调微信的接口:。这个接口需要三个参数:appid、secret、jscode。appid 和 secret 在微信公众平台的小程序后台能看到,secret 千万别硬编码在代码里,更不能传到前端,泄露了别人就能冒充你的小程序。正确做法是存在服务器环境变量里,或者用配置中心管理。接口返回的 JSON 里包含 openid、sessionkey,还有 unionid(如果用户绑定了开放平台)。openid 是核心,你得拿它去数据库里查有没有这个用户。
查不到用户,就说明是新用户,得注册。注册这步很多人纠结:要不要让用户填昵称头像?我的建议是,第一次登录直接创建用户,nickname 用默认的“微信用户”,头像用默认灰头像,等用户主动去完善资料再更新。为什么这么干?因为微信对 getUserInfo 接口已经改了策略,现在拿不到真实的昵称头像,只有灰色的默认头像和“微信用户”这个名字。你逼着用户填,反而降低转化率。等用户在小程序里操作到某个需要昵称头像的场景,再引导他授权,那才是合理时机。
拿到 openid 之后,后端要自己签发一个登录态给前端。这个登录态,一般用 JWT 或者自定义的 token。签发 token 的时候,把 openid 塞进去,然后设置过期时间,比如七天。前端拿到 token 后,存到 storage 里,每次请求接口的时候,在 header 里带上 。后端写个中间件,每个接口先验证 token 是否有效,有效就放行,无效就返回 401,前端收到 401 就跳回登录页重新登录。这套逻辑,是所有小程序登录的骨架,你把它搭稳了,后面加功能都顺。
有个坑必须单独拿出来说:sessionkey 的存储。sessionkey 是用来解密用户手机号的,但它的有效期跟 code 一样,过期了就不能用了。所以你拿到 sessionkey 之后,不能只存数据库,还得跟用户关联起来。最佳实践是:把 sessionkey 放在一个缓存表里,key 是 openid,value 是 sessionkey 和过期时间。每次需要解密手机号的时候,先查缓存,过期了就让前端重新走一遍登录流程。别把 sessionkey 当成永久的,微信随时可能让它失效,你得有兜底方案。
再聊聊登录态的刷新机制。token 过期了怎么办?最简单的是让用户重新登录,但体验差。好一点的做法是双 token 机制:一个 accesstoken 短期有效(两小时),一个 refreshtoken 长期有效(三十天)。accesstoken 过期了,前端拿 refresh_token 去换新的。这个小程序里怎么做?前端封装一个 request 方法,每个请求出去之前检查 token 是否快过期,如果快过期了,先调刷新接口,再发原请求。这个逻辑写起来有点绕,但值得花时间做,因为用户不会愿意隔几天就重新登录一次。
上线前的安全检查,千万别漏。第一,code2session 接口必须用 HTTPS 调用,微信强制要求,不能用 HTTP。第二,token 的签名密钥要用环境变量,不能写死在代码里。第三,数据库里存 openid 的字段要加密,至少要有访问权限控制。第四,接口要做频率限制,防止有人拿 code 刷你的登录接口。这些不是危言耸听,我见过有人把 secret 传到 GitHub 上,被爬虫扫到,直接调接口薅走了全部用户数据。你辛辛苦苦做的小程序,不能栽在登录的安全漏洞上。
说一个很多人忽略的点:登录流程的异常处理。code 无效、网络超时、微信接口返回错误码,这些都要在前端和后端分别做好处理。前端的做法是,登录按钮加 loading 状态,防止用户重复点击导致并发请求。后端的做法是,code2session 接口返回错误时,要区分是 code 过期还是 appid 不对,给出清晰的错误提示,方便排查。还有,前后端的日志都要打全,登录失败的时候,把 code、openid、错误信息都记录下来,不然出了问题你连从哪查都不知道。
微信小程序登录,说难不难,说简单也不简单。核心就是理解 code 换 openid 这个流程,然后围绕 openid 建立你自己的用户体系。代码量不多,但每一步都有讲究。你按这篇文章的顺序,从前端 wx.login 写起,再到后端换 openid、签发 token,把缓存、刷新、安全、异常处理都补上,一套完整的登录就落地了。上线之后,你还会遇到各种边界情况,但骨架在那,出问题你也能快速定位。写登录,最忌讳的就是一知半解就开干,把每一步的原理吃透,你才敢说会了。
