支付订单的生命周期是一台状态机:创建、支付中、已支付、已发货、已关闭,每个状态有明确的流转条件与超时规则。订单状态机的存储设计决定支付故障的排查效率与资损的防控精度。
---订单的状态流转
local ORDER_STATE = { created = 1, paying = 2, paid = 3, delivered = 4, closed = 5 }
function OrderLog.transit(orderId, newState)
local order = orderIndex[orderId]
local old = order.state
order.state = newState
QF_AppendOrderLog(orderId, old, newState, os.time())
if newState == ORDER_STATE.delivered then
OrderLog.markSettled(orderId)
end
end
状态机的每次流转写前后状态与时间戳,订单的生命周期按日志完整回放。状态流转的合法性校验:不允许从已关闭跳回支付中,非法的流转直接拒绝并告警。订单的超时规则:支付中超过 30 分钟自动关闭,关闭后的延迟到账走补单流程。
---延迟到账的补单流程
function OrderLog.recover(orders)
local recovered = 0
for _, o in ipairs(orders) do
if o.state == ORDER_STATE.paid and o.paidAt < os.time() - 1800 then
OrderDeliver.run(o)
recovered = recovered + 1
end
end
return recovered
end
补单的扫描每 5 分钟执行一次:支付成功但未发货的订单自动补发货,补发的动作与原发货同源。补发的记录与原订单关联,同一订单的多次补发被幂等标记拦截。订单的日志与支付平台的流水每日对账,差异订单在 24 小时内清结。
订单状态分布的快照监控,卡在中间状态的订单数量突增即为支付通道的异常信号。
状态机的并发流转曾经出现双向写入,同一订单被两个回调同时处理,状态流转的互斥锁补上。补单的幂等曾经依赖订单号的唯一性,平台重发不同单号的同一笔支付让幂等失效,平台的交易号纳入幂等键。
订单的状态与资损的关联监控:卡在已支付未发货的订单数量是资损风险的先行指标。对账的差异处理时限 24 小时,超时的差异升级到财务的专项。订单日志的保留期五年,支付类的纠纷追溯周期最长。
本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。
全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →
实战应用:用在哪里 世界BOSS降临、沙巴克突袭、双倍经验开启,世界事件的参与率取决于预告的触达。预告链路把事件表定时广播到…
实战应用:用在哪里 首杀竞拍的两家公会私下串通压价,成交价长期低于价值,BOSS产出被低价收割。串通防控方案:从出价行为、账…
实战应用:用在哪里 组队副本的战前分工面板上线前,队伍的坦克治疗输出全靠自觉,副本里为抢装备散伙的队伍每周十几支。分工确认功…
实战应用:用在哪里 分工确认的体验成败在面板:五个队员、三个岗位,队长拖动或点选标记,全员确认状态一目了然。面板用岗位色块与…
实战应用:用在哪里 邮件附件只写“礼包×1”,玩家不知道里面是什么,领取变成开盲盒。附件预览把礼包内容在邮件详情里展开:物品…
实战应用:用在哪里 野外精英的首杀权改为竞拍制:BOSS刷新前开放六十秒竞拍窗口,价高者的队伍获得首杀挑战权,出价冻结后未中…