专注营销系统开发11年为企业开拓营销空间!

微信小程序工具|微信小程序开发|微信小程序制作平台-龙图应用【XcxIP.com】

多年微信小程序专业开发商
中国行业十佳诚信企业、质量、服务

全国咨询热线15321026642

新闻资讯

新闻资讯
当前位置:网站首页>新闻资讯

微信小程序登录全流程开发,从零到上线的实战指南

发布时间:11-22来源:微信小程序工具|微信小程序开发|微信小程序制作平台-龙图应用【XcxIP.com】

打开微信开发者工具,新建一个项目,你会看到模板代码里已经躺着一个的调用示例。很多新手第一次看到这玩意儿,以为调一下就能拿到用户手机号,结果打印出来一串code,傻眼了。这玩意儿不是给你用的,是给后端换openid用的。微信小程序登录,从零到上线,坑比你想的多,但摸清楚链路之后,你会发现它其实是一条很规整的流水线。

微信小程序登录全流程开发,从零到上线的实战指南

先说清楚最核心的逻辑:小程序端永远拿不到用户的真实身份,只能拿到一个临时凭证code。这个code的有效期只有五分钟,而且只能用一次。你把code丢给自家后端,后端拿着这个code加上小程序的AppID和AppSecret,去微信的接口换sessionkey和openid。openid是用户在你这个小程序里的唯一ID,同一个用户在不同小程序里openid不一样。unionid则是同一个微信开放平台账号下,所有应用共享的ID,但那个需要额外绑定,不是默认就有的。

整个登录链路里,最容易翻车的是时序问题。我见过不少团队,前端调完拿到code,立刻就去调拿头像昵称,然后一股脑全丢给后端。这就有个大坑:这个接口在2022年之后改版了,它弹窗拿到的头像昵称不再是强制的,用户可以选择不授权。你必须在用户实际点击某个按钮的时候才去触发授权请求,不能在onLoad里偷偷调,否则弹窗直接不出来。更关键的是,这个授权信息和登录凭证是两码事,登录要的是code换sessionkey,用户资料是另一条线。

实战里,我建议你在app.js的onLaunch阶段只做静默登录。什么叫静默登录?就是调用拿到code,然后发给后端,后端换到openid和sessionkey之后,在后端生成一个自定义的登录态token,把这个token返回给前端存起来。你可能会问,为什么不直接用sessionkey当token?因为sessionkey是给后端解密用户手机号、getUserInfo的加密数据用的,它有自己的生命周期,而且微信官方建议不要把sessionkey下发到前端,它应该只存在你的后端服务器里。

这里有个细节很多人忽略:code换sessionkey的接口,返回结果里有一个字段,还有一个字段,但如果你接的是这个接口,需要在请求里带上jscode、appid、secret、granttype这四个参数。granttype固定是,这个别写错了。还有一个坑是,这个接口的域名是前缀的那个,很多人从网上复制代码,结果把漏了,直接404。

拿到openid之后,你的后端逻辑要分两种情况:如果库里没有这个openid,说明是新用户,你得给他创建一条用户记录,状态标记为未完善资料。如果库里已经有了,说明是老用户,直接更新一下最近登录时间就行。这里有个业务决策点:你到底是允许用户先以游客身份浏览,还是必须登录才能用?如果必须登录才能用,那你得在用户拒绝授权头像昵称的时候,给他一个默认头像和默认昵称,比如“微信用户”加一串随机数字,这样他至少能正常使用核心功能。千万别因为拿不到头像就卡住整个流程。

接下来是token管理。后端生成的自定义token,我建议用JWT或者简单的随机字符串都行,但一定要设置过期时间。微信官方推荐的sessionkey有效期其实是不定的,你没法主动控制,但你的业务token必须得有过期策略。一般建议两小时到七天之间,看你产品的敏感程度。前端拿到token之后,存在storage里,每次请求的时候放在header的Authorization字段里。这里有个小技巧:前端拦截器统一处理401状态码,一旦发现token过期,就重新走一遍静默登录流程,换新token,然后重放刚才失败的请求。这个体验做得好,用户根本感知不到token过期这回事。

还有一个绕不开的点是手机号登录。很多小程序为了拉新促活,会引导用户绑定手机号。获取手机号不能自己瞎写input让用户输,那样体验差,而且微信审核可能不通过。你得用这个组件。用户点击之后,微信会返回一个code给你,注意,这里返回的也是code,不是明文手机号。你得把这个code发给后端,后端再用sessionkey去调用微信的接口解密,才能拿到真正的手机号。也就是说,手机号获取的前提是,你已经完成了一次完整的静默登录,拿到了sessionkey。所以流程顺序是:先静默登录拿sessionkey,再引导用户点手机号按钮拿code,后端解密。

上线之前,还有几个配置项容易踩坑。第一,小程序后台的request合法域名必须配上你后端的HTTPS域名,而且必须是备案过的域名,不能是IP,不能带端口号。第二,如果要用,不需要在后台配置什么,但如果你要调用获取手机号之类的接口,需要在小程序后台申请开通相应的权限,有些类目还需要额外资质。第三,千万别把AppSecret放在前端代码里,那玩意儿一旦泄露,别人就能冒充你的小程序去调微信接口,后果很严重。正确做法是AppSecret只存在你的服务器环境变量里,前端永远不要接触。

说一个很多人吃过亏的问题:本地开发调试时,你会遇到一个很诡异的现象,在开发者工具里登录一切正常,但真机预览就报错。这多半是因为开发者工具默认不校验合法域名,而真机校验。你需要在开发者工具的详情设置里,勾选“不校验合法域名”才能本地联调,但真机测试必须保证域名配置正确。另外,如果你用了云开发,那登录逻辑会简单不少,云函数里可以直接用拿到openid,不需要自己手动调code换session_key,那套流程微信帮你封装了。但如果你用的是传统后端,老老实实按上面的链路走,稳扎稳打,基本不会出大问题。

从小程序端发起code,到后端换openid,再到生成业务token,带着token请求用户资料、手机号,整个过程环环相扣。很多人觉得登录是个小事,但其实它是整个产品的地基。地基没打牢,后面做支付、做消息推送、做客服会话,全都会跟着出问题。把这套流程吃透,你就能从“调通接口”进化到“理解机制”,遇到问题的时候,也能从根上排查,而不是靠瞎试。毕竟,微信的文档写得跟天书似的,但登录这件事的逻辑,理清楚之后,是能给你省下无数个加班的夜晚的。

分享到:0 用手机看
微信小程序登录全流程开发,从零到上线的实战指南

拍下二维码,信息随身看

试试用手机扫一扫,
在你手机上继续观看此页面。