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

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

2026-09-23 16:57 作者:996 技术组 996引擎Lua教程传奇脚本

实战应用:用在哪里

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

状态机的存储

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

框架设计师门仓库共享存取

【框架设计】师门仓库:师门物资的共享存取框架

实战应用:用在哪里 师门的公共物资散落在各成员背包里,打仗时才发现没药没符。师门仓库给师门一个共享物资池:成员捐献药品、符纸…

2026-09-23 18:19 996 技术组
框架设计药园种植产出

【框架设计】药园种植:师门药草的种植与产出框架

实战应用:用在哪里 师门任务的药材全靠成员自己采,供给不稳定还常被市场价卡脖子。师门药园给师门一块自留地:成员认领地块种植药…

2026-09-23 18:19 996 技术组
引擎触发锁妖塔定时开门封印

【引擎触发】锁妖塔:封印松动的定时开门触发设计

实战应用:用在哪里 锁妖塔是每周最受期待的限时地图:封印每七天松动一次,开门后两小时内妖物掉落翻倍,时间一过封印重合。定时开…

2026-09-23 18:19 996 技术组
玩法策划掌门挑战师门轮换

【玩法策划】师门掌门挑战:掌门之位的轮换与特权设计

实战应用:用在哪里 师门掌门长期连任,门派活动没人组织,新人没有上升通道。掌门挑战玩法给掌门之位装上轮换机制:每两周开放一次…

2026-09-23 18:19 996 技术组
后端接口行会建筑福利

【后端接口】行会建筑升级:建筑等级与行会福利接口

实战应用:用在哪里 行会驻地有一片空地,升级什么全凭帮主心情。行会建筑升级接口把驻地建筑体系化:聚义厅、兵器库、药庐、演武场…

2026-09-23 18:19 996 技术组
前端接口行会公告编辑预览

【前端接口】行会公告编辑:富文本公告的编辑与预览

实战应用:用在哪里 行会公告只有一行纯文本,写不下攻城安排。富文本公告编辑器支持分段落、插表情、标重点色,编辑区所见即所得,…

2026-09-23 18:19 996 技术组