微信小程序登录开发全攻略，手把手教你快速搞定

打开微信，随便点开一个小程序，它能知道你是谁，能调出你的头像、昵称，甚至能在群里喊出你的名字。这个看似简单的动作，背后藏着一整套登录流程。我见过太多开发者在小程序登录上栽跟头，明明代码写得没问题，一上线就各种报错。今天这篇东西，不整虚的，直接把我踩过的坑、试出来的路子，全给你摊开讲明白。

先搞清楚一个基本概念：小程序登录，本质上不是“登录”，而是“换票”。你把微信给你的临时凭证（code）拿去换一个能识别用户身份的标识（openid）。这个openid就像你的身份证号，每个用户在每个小程序里是唯一的。但这里有个容易懵的点——openid和unionid是两回事。如果你只做一个小程序，openid够用了；但如果你有公众号、App、小程序好几个产品，想让同一个用户在它们之间共享身份，那必须用unionid。这个区别我当年没搞清，结果数据表里存了一堆重复用户，那叫一个酸爽。

具体流程咱们走一遍。用户打开小程序，wx.login()一调用，微信服务器就返回一个code。这个code有效期只有5分钟，而且只能用一次。你把code通过wx.request传到你的后端，后端拿这个code加上你的AppID和AppSecret，去调微信的接口（jscode2session），换回来openid和session_key。session_key是用来解密用户手机号、获取用户信息的密钥，千万不能下发到前端，这是红线。我见过有人图省事把session_key传给前端，结果被用户抓包篡改，那酸爽，比老坛酸菜还带劲。

这里有个细节容易漏。wx.login()每次调用都会生成新的code，但code换session_key的接口有频率限制，官方文档写着单日上限，但实际开发中，如果你在高并发场景下频繁调用，会被限流。解决办法是前端做防抖，比如用户进入页面时只调一次，不要每次onShow都调。另外，code换openid的接口返回的openid要缓存到后端数据库，下次用户再来，直接用openid查库，不用再走一遍微信接口，这样既快又安全。

接下来说说用户信息获取。以前小程序可以直接wx.getUserInfo拿到头像昵称，但现在不行了。微信改版后，这个接口返回的是一堆匿名数据，昵称全是“微信用户”，头像是个灰色默认图。想拿真实信息？可以，但必须用户主动点击按钮触发。所以你得在页面上放一个“授权登录”的按钮，用户点了之后，通过button的open-type="getUserInfo"或者新版API的chooseAvatar、nickname-input来拿。这里有个小技巧，头像和昵称要分开引导，别一上来就弹窗，用户烦得很，直接拒绝，你的转化率就没了。

还有个大家经常搞混的点——手机号登录。手机号是小程序里最值钱的用户信息，但获取它需要企业认证的小程序，个人开发者没这个权限。而且手机号获取是收费的，每条几毛钱，别拿它当普通登录用，最好在用户需要付费、或者做高价值操作时才弹出来。技术实现上，手机号验证也是走code换session_key，然后用session_key去解密getPhoneNumber接口返回的加密数据。注意，这个接口的调用频率限制更严格，我遇到过一次被限流，用户疯狂点手机号登录，结果接口直接403，页面崩了，那叫一个尴尬。

说到安全，必须提醒你一个容易忽略的坑——登录态过期。小程序不像网页有session，它靠的是后端自己发的token。你拿到openid后，自己生成一个token发给前端，前端存到storage里，后续请求带上这个token。但token有过期时间，如果用户长时间不用，token失效，你得让前端自动跳回登录页。但这里有个体验问题，用户正逛着商品呢，突然被踢出去，很恼火。所以建议用静默登录——token过期时，前端先调wx.login()拿新code，后端用新code换新token，整个过程用户无感知。静默登录不是让你每次都调wx.login，而是做好过期判断和自动刷新逻辑。

再提一嘴云开发。如果你用的是微信云开发，登录这块能省不少事。云开发自带openid获取能力，在云函数里直接拿cloud.getWXContext().OPENID就行，不用自己写jscode2session的调用。而且云开发的数据库权限设置里，可以按openid自动隔离数据，省了你手写鉴权的功夫。但云开发也有坑——免费额度有限，并发一高就要花钱，而且冷启动延迟比传统服务器高。我的建议是，小项目、个人练手，云开发真香；要商业化、要稳定，还是自己搭后端吧。

给你一个完整的代码思路，照着写就能跑通。前端：wx.login拿到code，传给后端；后端：接收code，调微信接口换openid，查数据库判断是否老用户，生成token返回；前端：存token，存用户信息，跳转首页。就这么简单，但每一步都有细节，每一步都可能出错。我见过最蠢的报错是AppSecret填错了，结果调接口一直返回40001，排查了一下午，发现是复制的时候多了个空格。所以，登录这块，细心比技术重要。

微信小程序登录，说难也难，说简单也简单。难在细节多，坑多；简单在流程固定，模式清晰。你只要把code换openid这条主路径走通，再处理好token过期和用户信息引导，基本就稳了。别想着一步到位，先把最基础的跑通，再慢慢优化体验。毕竟，用户不会关心你用了什么技术，他只关心打开小程序能不能顺畅地用起来。而这，恰恰是登录这第一道门要解决的事。