做小程序虚拟支付的你,先把这个登录时效搞明白

前言

青萍生图小程序的充值功能跑起来没多久,我就收到一类奇怪的反馈。

用户明明登录着,点充值却弹出支付失败,错误信息是 SIGNATURE_INVALID。

直译过来是签名无效,第一反应都会怀疑签名算法写错了。

可它时好时坏,刚进小程序的人付款一路顺畅,逛了一会儿再来充值的就挂。

折腾一圈才发现,锅不在算法,在登录态的时效上。

如果你也在做小程序虚拟支付,这个坑值得提前搞明白。

报错的真面目

我把失败订单和登录日志对了一遍,失败集中在登录后隔了一阵子才付款的用户身上。

虚拟支付拉起收银台要带两个签名,一个管商户,一个管用户。

paySig 用后台配置的 AppKey 计算,证明这笔请求确实出自你的服务端。

signature 用 session_key 计算,证明用户当下的登录身份。

SIGNATURE_INVALID 对应官方错误码 -15005,文档里的说法是用户态签名 signature 错误。

这个码只说明签名没通过,算法写错、字段拼错、key 旧了,报的都是它。

旁边还有个 -15007,含义更直接,就是 session_key 过期。

两个码症状很像,但 -15007 才是把原因说死的那个。

弯路都走了一遍

被报错文案带着,我先在签名算法上查了很久。

HMAC 的拼接顺序、字段增减、key 的编码方式,挨个对了一遍,都没问题。

也怀疑过 AppKey 拿错,沙箱和正式不同,没错。

真正的转折来自一次对照测试。

登录后立刻点支付,成功。

把小程序放半小时再点,十有八九会失败。

签名代码一行没动,变的只有时间,那就只剩登录态这一个变量了。

算法没错,密钥旧了

微信官方从不公布 session_key 的固定有效期,文档里能找到的唯一说法,是会根据用户使用小程序的行为动态续期。

小游戏虚拟支付的技术手册里倒是给过一个量级,失效时间是天级别。

但天级别不等于高枕无忧,任何一次新的 wx.login 都可能触发刷新,旧的 session_key 立即作废。

用户在手机和电脑同时登录,或者另一个模块悄悄调了一次登录,服务端那份 key 就旧了。

回头看那次对照测试,挂掉的多半不是 key 的寿命,而是它已经不被微信认可了。

旧 key 算出来的 signature,微信那边自然验不过。

报错只说签名无效,把人往算法上带,这是整个坑里最耽误时间的部分。

支付前查登录态

搞清楚原因后,方案反而简单,难的是放在哪查。

我先想过把 session_key 存下来一直用,可它随时会被新的登录刷掉,存的那份迟早变旧,走不通。

也考虑过进小程序时查一次,同样不够,浏览页面的几分钟里登录态照样可能变旧。

而 wx.login 有频率限制,官方禁止短时间内多次自动重试,高频重登不现实。

所以我最后把检查挪到了点支付那一刻。

点充值时,服务端先用 auth.checkSessionKey 校验手里的 key,客户端补一道 wx.checkSession。

有效就直接签名拉起收银台。

查到过期就静默重走一遍登录,拿到新的 session_key 重新签名,再拉起收银台。

整个重登用户无感知,最多觉得支付弹窗慢了半秒。

支付前登录态检查的修复前后流程

官方手册也列了重登时机清单,进入时检查、报错后重登都在里面,我取的是点支付这一种,离签名最近。

上线之后

修复上线后,这类报错从日志里基本消失,用户也没再遇到点充值被失败弹窗拦住的情况。

顺手在监控里给 -15005 和 -15007 都打了标签,一出现就先往登录态查。

后来给青萍生图加新支付场景时,登录态检查已经封装成公共方法,新场景直接调。

当然它有边界,签名依赖登录态的接口才用得上,频次极低的场景报错后重试也说得通。

这个坑教会我的事就一件:报错文案说签名无效,不代表问题真的在签名。