同一笔订单的支付通知,十几秒里进来两遍,订单被改了两次,发货队列也多收一条消息。我一般先存原始报文再验签,判重交给唯一索引,状态更新带上原状态做条件,最后用主动查单和每日对账兜底。文末附上线前自查清单,重复发货、金额对不上都能照着查。
同一笔钱,日志里来了两回
联调那会儿我盯着日志,同一笔 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 说明需求。本文为技术经验分享,具体方案以实际沟通为准。