微信小程序把session带回服务器的核心做法是:在登录成功后把服务器下发的session id存入本地缓存,每次请求时从缓存取出并通过请求头或参数携带给服务器,服务器再据此识别用户状态。很多开发者第一次接手小程序时,容易被前端的无状态特性搞晕,以为像浏览器那样自动带Cookie就行,实际上小程序没有自动Cookie机制,需要手动管理。
session和token:先从本质说起
要搞清楚怎么带session,得先明白session到底是什么,服务器为了识别同一个用户,会在用户登录成功后生成一个唯一标识,也就是session id,这个id通常存在服务器内存或Redis里,对应的用户信息也一并存好,客户端需要做的,就是每次请求都把这个id原封不动地交回去,服务器才能对上号。
传统的Web端浏览器会自动处理Cookie,但微信小程序不一样,wx.request并不像浏览器那样自动存储和携带Cookie,行业共识认为,小程序开发者必须自己承担session的传递和续期工作,所以问题就变成两个:session存在哪里,以及用什么方式塞进每次请求里。
微信小程序把session带回服务器的三种方案对比
不同团队选的方案不一样,主要取决于后端架构和业务场景,下面这几种是实务中最常见到的。
手动维护Cookie并放入请求头
这是最贴近浏览器行为的做法,登录接口返回的响应头里如果有Set-Cookie字段,你就把它解析出来,拼成字符串存到wx.setStorageSync里,之后每次请求,从storage取出,放入Header的Cookie字段。
优点是后端完全不用改,原本在Web端怎么读Cookie,小程序里依然怎么读,缺点是你要自己处理Cookie的过期、覆盖、多个字段的拼接,而且有些后端返回的Set-Cookie带HttpOnly标志,小程序端照样可以读,这点不用担心。
具体动作是:
- 登录成功后,从
res.header['Set-Cookie']或res.header['set-cookie']拿到数组或字符串。 - 用分号和空格拼接所有cookie项,存为
cookie变量。 - 在wx.request的header中写
'Cookie': cookie。 - 如果后续服务器更新了Set-Cookie,记得把旧的替换掉,不是拼接追加。
自定义请求头传递session id
后端主动配合的话,可以在登录接口返回一个sessionId字段,前端存起来,请求时放进自定义头,比如X-Session-Id,后端从request.headers里取这个字段,然后去Redis里查对应session。
这个方案的好处是语义清晰,不受Cookie规范限制,坏处是后端所有接口都要改成从自定义头取,如果原先有大量基于Cookie的中间件,会带来改造量,但对新项目来说,这其实是最干净的做法。
把session id放在请求参数里
有的团队懒省事,直接把session id拼在URL的query里或者放在POST的body里,这种方式技术上能跑通,但非常不推荐,URL参数会出现在日志和分享链接里,安全风险极大,body里携带还算可以接受,但后端处理起来比头麻烦,只有极个别没法改后端的临时项目才会这么干。
下面用表格快速对比这三种方案:
| 方案 | 存储位置 | 携带方式 | 后端改动 | 推荐度 |
|---|---|---|---|---|
| Cookie模拟 | 本地缓存 | 请求头Cookie字段 | 无需改动 | 较高,适合老项目 |
| 自定义Header | 本地缓存 | X-Session-Id等 | 需要改 | 高,适合新项目 |
| URL或Body | 本地缓存 | query或body | 需要改 | 低,不推荐 |
彻底搞懂session过期处理:小程序前端应该做什么
很多人把session带回服务器后,发现过一会儿请求就报401,其实这不是带回方式的问题,而是session生命周期管理没做对,session不是永久的,服务器一般会设置一个过期时间,比如30分钟无操作就失效,前端能做的,就是拦截401响应,然后触发重新登录。
推荐的做法是封装一个统一的请求工具函数,所有wx.request都走这个函数,逻辑是这样的:
- 请求发起前,从storage读取session标识,放进header。
- 收到响应后,如果状态码是401,清掉本地session。
- 跳转到登录页,让用户重新登录,登录成功后再重放之前的请求。
这套逻辑在电商小程序里特别常见,用户逛了半天商品详情,加购物车时session过期了,如果直接让用户重新登录,购物车内容可能丢,更好的做法是把失败的回调暂存起来,重新登录后自动重放,体验会好很多。
微信小程序session管理在电商场景下的实现细节
电商场景比纯展示类小程序对session的要求高不少,因为涉及购物车、订单、支付状态,用户可能长时间停留,这时候除了携带session,还要考虑续期和多端同步。
续期一般由后端来做,前端只需要在每次成功响应后,重新保存服务器返回的最新session头,如果服务器是滑动过期策略,前端无需额外操作,如果服务器固定周期过期,前端要考虑在打开小程序时先调一次静默登录接口,把session延长。
多端同步则是另一个麻烦,用户在PC端登录过,小程序端又登录,会产生两个不同session,这种情况要么后端合并用户体系,要么前端在登录时通过手机号或unionId关联同一账号,具体怎么选,要看业务和后端的支持程度。
还有一个容易踩的坑:图片加载不经过wx.request,如果你把session放在请求头里,那么<image>标签加载需要鉴权的图片时是带不上这个头的,解决办法是用wx.downloadFile,它支持header,或者后端把图片鉴权改成临时URL签名方式,避免session依赖。
小程序session丢失的排查路径和本地存储细节
有时候session明明存了,但服务器就是不认,按照下面顺序排查,多数情况下能解决。
- 第一,登录接口返回的Set-Cookie是大写还是小写?微信返回的header键名统一是小写,但某些后端框架会给大写,你得同时判断
res.header['Set-Cookie']和res.header['set-cookie']。 - 第二,存入storage时有没有把cookie字符串处理干净?有些后端会额外返回
Path=/; HttpOnly等属性,这些属性不需要传给服务器,传给服务器也没问题,但要注意分号分割的点。 - 第三,请求头里有没有被其他代码覆盖?如果你封装了请求工具,但有些页面直接调了wx.request,那就会漏掉header。
- 第四,检查服务器是否配了跨域白名单,小程序请求没有浏览器同源策略限制,但如果在开发者工具里开了域名校验,可能影响。
本地存储建议统一用一个key,比如session_key,微信的wx.setStorageSync是同步的,性能开销极小,不需要用异步版本,但在请求函数中频繁读取,可以考虑把session先存到全局变量里,只在登录和清除时同步到storage,减少无谓读写。
常见疑问速览:微信小程序session和token到底怎么选
为什么我的小程序每次重新打开都要重新登录? 大概率是因为服务器session存在内存里,而小程序进程一旦被系统杀掉,冷启动后请求带上了旧session,但服务器那边的session已经没了,解决方法是后端改用持久化session存储,比如Redis,或者换token机制。
能不能用token完全替代session? 能,而且很多中大型小程序都是这么做的,token本身就是一段加密字符串,服务器不存session也可以验证签名,但token也有过期问题,通常配合refresh_token双token方案,如果是简单的内部工具类小程序,session就够了。
开发者工具里带session没问题,真机上不行? 检查一下真机上有没有走完整登录流程,很多情况下开发者工具里因为之前调试时登录状态还在,真机是全新环境,没触发登录,在真机上打开调试模式看一下请求头的实际发送情况,基本能定位。
微信小程序session安全防护的几个硬指标
把session带回服务器只是第一步,后续还得防止被盗用,行业内的基本共识是:session必须放在本地缓存中,绝不能写死在代码里,如果你把session拼在某个JS文件里,包一发布就泄露了,本地存储的session应尽量缩短有效期,即使被不法分子拿到,也很快失效。
服务器端要校验session来源,对于敏感操作,比如改密码、支付,应要求用户二次验证,微信登录能力本身提供了wx.login获取的code,后端拿到code和appid、secret换session key,这个过程要保证是HTTPS,任何地方都不要用HTTP明文传输session。
你的服务器端日志里,也建议做一下脱敏处理,session值打码,只保留前几位和用户ID,防止日志泄露引发安全问题,这一点很多人会忽略,但确实值得注意。
关于session问题,微信官方文档告诉你的并不多
微信官方文档里对wx.request的header用法描述得很简略,很多细节是开发者自己踩坑踩出来的,业内专家指出,小程序的网络层设计本质上就是一个可自由控制的fetch,开发者需要像做原生App一样管理认证状态,而不能指望浏览器行为。
真正聪明的做法是从架构上想清楚:你的后端是要兼容老的Cookie体系,还是顺势拥抱自定义header,前者适合已有成熟Web后台的团队,后者适合新项目从零做,选好了再动手,后面维护成本会低很多。
Q&A:微信小程序怎么把session带回服务器算标准操作?
Q1:微信小程序请求服务器时session放在请求头还是请求体更好?
放在请求头更好,具体是放在Cookie字段还是自定义字段取决于后端设计,请求体会污染业务数据结构,且POST和GET的处理方式不统一,请求头则对所有方法一致,后端拦截器和中间件处理起来也方便。
Q2:小程序冷启动后session丢失怎么办?
先确认是前端的session存储丢了还是服务器端的session记录没了,前端存在storage里基本不会丢,除非用户清缓存或卸载重装,服务器端session如果存在内存中,重启或扩容都会丢,换Redis存储,并让前端在启动时静默调一次检测接口,能有效解决这个问题。
Q3:session和token在小程序登录流程里能结合用吗?
可以,常见做法是登录时后端生成一个token,同时用token作为key在服务端保存session信息,前端只存token,每次请求携带token,后端解析后找到对应的session数据,这样既保留了服务端session的实时控制能力,又利用了token便于在客户端存储的特点。
首发原创文章,作者:王坚,如若转载,请注明出处:https://idctop.com/article/800136.html


