支付问题的排查顺序比排查技巧更重要。同一个现象——「用户付了钱,订单还是待支付」——可能是四个完全不同环节的问题。按顺序查,五分钟能定位;乱猜,改一天也改不对。
顺序是:有没有收到请求 → 验签过没过 → 业务处理成功没 → 应答格式对不对。每一层都有明确的判断依据,不用猜。
第一步:确认回调请求到底有没有到服务器
这是最关键的一步,也是最容易被跳过的一步。很多人一上来就怀疑验签、怀疑代码,结果发现请求压根没进来。
看两个地方:Web 服务器的访问日志里有没有对应时间点的 POST 请求;如果前面有 nginx 或负载均衡,日志要看到这一层。如果日志里什么都没有,问题在通道上,不在代码里。
通道问题常见三种:
- notify_url 不是公网可达的地址。填了内网 IP、填了带参数的地址、填了 http 但强制跳 https,微信都发不进来。这个地址必须是不带参数、公网直连、证书有效的 https 地址。
- 防火墙或安全组拦了。微信的出口 IP 不固定,如果做了 IP 白名单,回调会被挡。回调接口不要做来源 IP 限制。
- URL 大小写或路径写错。填完之后自己用工具发一个 POST 过去,确认能通,再下单测试。
第二步:看验签有没有过
请求进来了但业务没执行,八成卡在验签。验签失败会抛异常,但很多代码把异常吞掉了,日志里只留一句「处理失败」,看不出原因。
验签失败三大原因:
- 平台证书过期。微信平台证书有有效期,到期不换,验签全部失败。这是最隐蔽的一种,因为代码没改、配置没动,突然就全挂了。要定期检查证书有效期,并且实现证书自动更新。
- 用了 APIv3 密钥去验签。APIv3 密钥是用来解密的,验签用的是微信平台证书的公钥,两者别搞混。
- 拿到了请求体但被框架改过。验签必须用原始请求体,如果框架把 JSON 解析后又重新序列化,字段顺序和空格变了,签名就对不上。要在读取原始 body 的地方做验签。
第三步:查业务处理有没有幂等
「重复到账」「重复发货」「余额加了两次」——这类问题只有一个原因:没做幂等。
微信的回调不是「发一次就完」,失败会重试,最长持续一天多,间隔从十几秒逐步拉长。如果你的接口返回的不是成功应答,或者处理超时,微信就会重发。所以同一个订单收到五次回调是正常现象,代码必须能扛住。
幂等的做法:以商户订单号(out_trade_no)为唯一键,处理前先查状态,已处理的直接返回成功,不再执行业务逻辑。这一层要放在数据库事务里,或者用唯一索引兜底,避免并发下两个请求同时判断「未处理」。
顺便提醒:状态机要单向流转。待支付只能变成已支付,不能反过来。任何允许状态回退的写法,都会在重试下出问题。
第四步:应答格式对不对
这一步最冤——业务全做对了,但因为返回内容不对,微信认为失败,一直重试,用户看到的是「支付未完成」,后台看到的是「已到账」。
微信支付 V3 的回调要求:HTTP 状态码 200,且返回内容必须是 JSON 格式的成功标识。返回一段 HTML、返回一个空字符串、返回「success」小写字符串,都可能被判失败。不同接口版本要求略有差异,按你接入的版本文档来,别凭记忆写。
还有一个坑:应答要在业务处理完之后返回,但处理不能超过超时时间。如果业务逻辑里有耗时操作(发短信、生成文件、调用外部接口),先落库标记、立即返回成功,耗时操作放异步队列做。处理超时会导致微信重试,然后又回到第三步的幂等问题。
日常该做的两件事
- 每天对账。拉微信账单和本地订单做比对,重点看「微信有、本地无」和「金额不一致」两类。对账能兜住所有实时回调漏掉的情况。
- 给回调加监控。连续 5 分钟没有收到任何回调就报警,证书到期前 30 天提醒。这两件事做了,绝大多数支付事故可以在用户发现之前处理掉。
