首页 / 技术文章 / API与系统集成
API与系统集成

支付回调来了两遍,订单会不会改两次

发布于 2026-11-17更新于 2026-11-17
支付回调来了两遍,订单会不会改两次

同一笔订单的支付通知,十几秒里进来两遍,订单被改了两次,发货队列也多收一条消息。我一般先存原始报文再验签,判重交给唯一索引,状态更新带上原状态做条件,最后用主动查单和每日对账兜底。文末附上线前自查清单,重复发货、金额对不上都能照着查。

同一笔钱,日志里来了两回

联调那会儿我盯着日志,同一笔 out_trade_no,十几秒里进来了两遍。

头一遍把订单改成已支付,顺手往发货队列塞了条消息。第二遍又塞了一条。钱只收了一次,仓库那边差点打出两张单。

麻烦就在这。

支付平台的通知本来就可能重发。我们这边响应慢了、网络抖一下、返回的字符串跟它要的对不上,它就按自己的节奏再推一次,有的隔一阵还推。等对方只发一遍?这个等不起。我一般先不急着往业务代码里加判断,把 /var/log/nginx/error.log 和 notify_log 表按时间对一遍,先弄清这两回是同一份报文重发,还是真有两笔都付了钱。两种情况长得几乎一样,处理方式完全不同。这个我踩过,先分清再动手。

验签之前,先把那串原文存下来

拿到请求,我先把没动过的原始字符串整串读出来。file_get_contents('php://input') 读一次,存进 notify_log,然后才验签。

别先 json_decode() 成数组、再拼回字符串去算签名。

参数顺序、空值、转义、数字前面那个零,动一处就对不上,你还会以为是密钥配错了。哦对了,原始报文只在这一处读,后面别再从 $_POST 里凑。

验签一般走 openssl_verify(),或者按渠道约定做一次 hash_hmac(),比的是对方签名和你用公钥还原出来的结果。没过就直接返回失败,别往下解析业务字段,更别写订单。这层挡掉的伪造请求,后面几层补不回来。

响应体也得照文档来。有的渠道要一个纯字符串 success,有的要一段 XML。返回 200 但内容不对,对方照样当失败接着推。

验过了也别把原文删了。连时间、HTTP 头和验签结果一起留着,回头查某笔钱到底通知过几次,全靠这张表。

判重这活,交给数据库那把唯一索引

刚上手那版,多半是「先查有没有处理过,没有就处理」。两个通知几乎同时到,两边都查到空,然后都往下走。这层判断等于没写。

并发得让数据库兜底。我在通知记录表上给平台通知 id 建唯一索引 uk_notify_id,处理前先插一条,插不进去就当处理过,直接回成功。MySQL 8.0 撞唯一键抛 1062,catch 住当重复通知,别当系统错误去告警。

说白了,判重别全交给应用代码。这跟 MySQL 索引与慢查询 里讲的是一回事。

用哪个字段当幂等键也有的挑。平台通知 id 每次重发都一样,拿来当键就行,可有些渠道偏不给。退一步用商户订单号加通知类型,还得自己约定同一笔的多次成功通知算一条,退款和支付分开。这个要看渠道文档,没法一概而论。我会把字段和唯一键写进表结构,别留在代码注释里。真到线上再改,代价就大了。

容易漏的还有一处:后到的失败或关闭通知,别让它把已支付改回去。

订单状态,只准往前走一次

把状态想成一条单行道。待支付、已支付、已发货、已退款,只准按这个方向流。

更新的时候带上原状态做条件,写成 UPDATE orders SET status = 'paid' WHERE id = ? AND status = 'pending',再看 rowCount() 是不是 1。影响 0 行,说明这条通知来晚了或者重复了,正常回成功,不用报错。

两遍通知同时进来,行锁让它们排队,第二遍的条件就不成立了。

真出事的是先 SELECT 出订单、在内存里改完再整体 save() 回去。两个请求各读到旧状态,谁后写谁覆盖,前面那次发货就丢了。这个坑我踩过。

金额也得一起核。回调里的 total_amount 和下单时对不上,别改状态,记一条异常等人看。校验我一般放在验签之后、状态更新之前,位置放错了后面补起来很别扭。至于部分退款要不要单独记流水,得看业务,别的渠道我没验证过同一套状态够不够用。这句没法说死。

回调会丢,还得反着去问一次

回调是对方推过来的。推没推到、你收没收到,中间断哪一环都没人兜底。所以还得反着来一次。

待支付超过一段时间没动静的订单,用查单接口去问平台,以平台返回的为准改状态。扫哪些单、扫多久,写在 config/pay.php 里比写死在脚本里好改。

查单接口自己也会超时,别让它把整批任务卡住。我一般给每笔单记一个下次可查的时间,失败就往后挪,一轮里不死等。

查单和回调撞一起是常事,两条路最后都得走同一套条件更新加唯一键,别各写一份。第三方回调地址还得在鉴权那层放行,跟 ThinkPHP 6 中间件鉴权 里把回调加进白名单一回事。漏了的话请求根本走不到验签,日志里只看到 401。

再往后是每天的对账文件。它比实时通知慢,但能兜住通知丢了、查单超时、金额不一致这些零散情况。发现差异我一般只记下来,不自动改钱,让人确认过再动。

重试也留个上限,内部别无限循环,配一条告警让人看得见就行。

上线前我一般走一遍这些

这些跑完,剩下的多半是渠道差异。有的通知带退款,有的状态值叫法都不一样,套不进同一套枚举。定枚举之前先翻渠道文档里状态流转那段,别照着某一家写死。

接口对接和支付模块改造,想找人一起把范围、异常分支理清楚,西安尊云科技承接程序定制开发、二次开发与接口对接,可通过微信 yvsm316 说明需求。本文为技术经验分享,具体方案以实际沟通为准。

返回技术文章