CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
数据存储

【数据存储】支付日志的订单状态机

2026-09-21 10:53 作者:996 技术组 0 阅读 数据存储

实战应用:用在哪里

支付订单的生命周期是一台状态机:创建、支付中、已支付、已发货、已关闭,每个状态有明确的流转条件与超时规则。订单状态机的存储设计决定支付故障的排查效率与资损的防控精度。

状态机的存储

lua

---订单的状态流转
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 分钟自动关闭,关闭后的延迟到账走补单流程。

补单的处理

lua

---延迟到账的补单流程
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 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付,内容以官方知识库与真实项目为出处,按版本持续修订。

← 返回文章地图返回研学路径

最新技术文章 · 实战干货

LATEST ARTICLES

全站技术干货持续更新:996 引擎 / Lua 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

网络通信事件广播

【网络通信】动态事件预告:世界事件的定时广播链路设计

实战应用:用在哪里 世界BOSS降临、沙巴克突袭、双倍经验开启,世界事件的参与率取决于预告的触达。预告链路把事件表定时广播到…

2026-09-22 16:16 996 技术组 · 0 阅读
安全加密竞拍串通

【安全加密】首杀竞拍串通防控:围标抬价的识别与处置设计

实战应用:用在哪里 首杀竞拍的两家公会私下串通压价,成交价长期低于价值,BOSS产出被低价收割。串通防控方案:从出价行为、账…

2026-09-22 16:16 996 技术组 · 0 阅读
案例复盘副本分工

【案例复盘】战前分工漏配:分工确认功能的补课复盘

实战应用:用在哪里 组队副本的战前分工面板上线前,队伍的坦克治疗输出全靠自觉,副本里为抢装备散伙的队伍每周十几支。分工确认功…

2026-09-22 16:16 996 技术组 · 0 阅读
界面UI组队面板

【界面UI】战前分工确认面板:岗位标记的界面实现

实战应用:用在哪里 分工确认的体验成败在面板:五个队员、三个岗位,队长拖动或点选标记,全员确认状态一目了然。面板用岗位色块与…

2026-09-22 16:16 996 技术组 · 0 阅读
前端接口邮件预览

【前端接口】邮件附件预览:附件内容的界面预览实现

实战应用:用在哪里 邮件附件只写“礼包×1”,玩家不知道里面是什么,领取变成开盲盒。附件预览把礼包内容在邮件详情里展开:物品…

2026-09-22 16:16 996 技术组 · 0 阅读
引擎触发竞拍窗口

【引擎触发】首杀竞拍窗口:竞拍阶段的定时触发设计

实战应用:用在哪里 野外精英的首杀权改为竞拍制:BOSS刷新前开放六十秒竞拍窗口,价高者的队伍获得首杀挑战权,出价冻结后未中…

2026-09-22 16:16 996 技术组 · 0 阅读