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

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

2026-09-21 10:46 作者:996 技术组 数据存储

实战应用:用在哪里

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

状态机的存储

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 实战帖,语法、参数与示例一篇讲透。进入文章地图 · 查看全部 →

网络通信行会集结

【网络通信】行会集结令:跨地图集结消息的链路设计

实战应用:用在哪里 沙巴克开战前600秒,行会会长一键集结,全会在线成员无论在哪张图都收到带坐标的集结消息,点击直达集合点。…

2026-09-22 15:09 996 技术组
运维发布压测预演

【运维发布】新玩法容量预演:远征副本上线的压测编排设计

实战应用:用在哪里 远征副本上线前夜,压测编排把“上线会不会崩”变成一场有脚本的预演:模拟满员远征、三选一齐选、奖励齐领三个…

2026-09-22 15:09 996 技术组
案例复盘结义Buff

【案例复盘】结义加成重复发放:协同Buff的重复结算复盘

实战应用:用在哪里 结义合击玩法上线三天,客服收到“攻击加成叠了三层”的报告:同一次合击,三个入口各挂了一次加成Buff。复…

2026-09-22 15:09 996 技术组
界面UI任务奖励预览

【界面UI】任务奖励预览:战力换算提示的界面设计

实战应用:用在哪里 “强化石×3”值不值得跑一趟毒蛇山谷,玩家心里没数。任务接取页的奖励预览把物品换算成战力参考值:每件物品…

2026-09-22 15:09 996 技术组
前端接口帮助检索

【前端接口】帮助中心自助查询:关键词检索与直达实现

实战应用:用在哪里 “转生怎么升”“红名怎么洗”这类问题八成答案都在帮助中心,玩家却习惯直接问客服。自助查询把帮助条目做成关…

2026-09-22 15:09 996 技术组
引擎触发战士攻击节奏

【引擎触发】烈火剑法前后摇:攻击节奏的触发调优设计

实战应用:用在哪里 烈火剑法的打击节奏由前摇与后摇决定:前摇太长玩家觉得迟钝,后摇太短连招没有张力。节奏调优把前后摇参数化:…

2026-09-22 15:09 996 技术组