支付问题的排查顺序比排查技巧更重要。同一个现象——「用户付了钱,订单还是待支付」——可能是四个完全不同环节的问题。按顺序查,五分钟能定位;乱猜,改一天也改不对。

微信支付回调问题四步排查:先看访问日志确认请求有没有到服务器,没有就是通道问题;再查验签,平台证书过期最隐蔽;然后查幂等,以商户订单号为唯一键;最后查应答格式,必须返回 200 加 JSON 格式的成功标识。
支付回调问题:四步排查顺序

顺序是:有没有收到请求 → 验签过没过 → 业务处理成功没 → 应答格式对不对。每一层都有明确的判断依据,不用猜。

第一步:确认回调请求到底有没有到服务器

这是最关键的一步,也是最容易被跳过的一步。很多人一上来就怀疑验签、怀疑代码,结果发现请求压根没进来。

看两个地方:Web 服务器的访问日志里有没有对应时间点的 POST 请求;如果前面有 nginx 或负载均衡,日志要看到这一层。如果日志里什么都没有,问题在通道上,不在代码里。

通道问题常见三种:

第二步:看验签有没有过

请求进来了但业务没执行,八成卡在验签。验签失败会抛异常,但很多代码把异常吞掉了,日志里只留一句「处理失败」,看不出原因。

验签失败三大原因:

第三步:查业务处理有没有幂等

「重复到账」「重复发货」「余额加了两次」——这类问题只有一个原因:没做幂等。

微信的回调不是「发一次就完」,失败会重试,最长持续一天多,间隔从十几秒逐步拉长。如果你的接口返回的不是成功应答,或者处理超时,微信就会重发。所以同一个订单收到五次回调是正常现象,代码必须能扛住。

幂等的做法:以商户订单号(out_trade_no)为唯一键,处理前先查状态,已处理的直接返回成功,不再执行业务逻辑。这一层要放在数据库事务里,或者用唯一索引兜底,避免并发下两个请求同时判断「未处理」。

顺便提醒:状态机要单向流转。待支付只能变成已支付,不能反过来。任何允许状态回退的写法,都会在重试下出问题。

第四步:应答格式对不对

这一步最冤——业务全做对了,但因为返回内容不对,微信认为失败,一直重试,用户看到的是「支付未完成」,后台看到的是「已到账」。

微信支付 V3 的回调要求:HTTP 状态码 200,且返回内容必须是 JSON 格式的成功标识。返回一段 HTML、返回一个空字符串、返回「success」小写字符串,都可能被判失败。不同接口版本要求略有差异,按你接入的版本文档来,别凭记忆写。

还有一个坑:应答要在业务处理完之后返回,但处理不能超过超时时间。如果业务逻辑里有耗时操作(发短信、生成文件、调用外部接口),先落库标记、立即返回成功,耗时操作放异步队列做。处理超时会导致微信重试,然后又回到第三步的幂等问题。

日常该做的两件事

排查口诀:先看日志有没有进来,再看验签有没有过,然后看幂等有没有做,最后看应答格式对不对。四步走完,问题一定在里面。