Lua唯一序列：时间戳加自增的标识生成

【语法】
一、机制原理
线上事故：前端本地生成的单据号两台设备撞了号，提交时互相覆盖，一单顶掉另一单。唯一序列的构造三层叠加：时间戳打头保证随时间趋势唯一；同一秒内的多笔靠自增序列区分，序列随单递增；再拼上设备标识位区分来源。单机内时间戳加自增已经够用，跨设备靠设备位划清界线，随机数撞号的旧路就此封死。
二、错误写法

lua

-- 错误：随机数当唯一号，撞号互相覆盖
local orderNo = tostring(math.random(100000))

三、正确写法

lua

local seq = 0
local DEVICE = 7
local function newId()
    seq = seq + 1
    return string.format("%d%04d%d",
        os.time(), seq, DEVICE)
end
local a = newId()
local b = newId()
local label = panel:getChildByName("idText")
label:setString(tostring(a ~= b))

四、引擎验证
同秒内连出两单，自增序列保证两号不同；跨秒由时间戳天然区分。
五、FAQ
问：跨设备怎么防撞？
答：设备标识位拼进号尾划清来源。
问：重启后序列归零会撞吗？
答：时间戳已前移，旧号新号天然不同。

作者履历与出处

本文由 996 技术组基于 996 引擎官方知识库与浮生梦老师课程体系整理。团队长期从事传奇类引擎 Lua 后端逻辑、客户端界面与商业版本交付，内容以官方知识库与真实项目为出处，按版本持续修订。

📖 接口说明API × 3

tostring 系统函数 tostring(...)

...

返回：把任意值转为字符串

转字符串

math.random 系统函数 math.random(...)

...

返回：生成随机整数或浮点数

随机数

string.format string.format(fmt, ..., 标准库, 按格式串生成字符串，高频路径注意临时串的 GC 开销。, string)

fmt

...

标准库

按格式串生成字符串，高频路径注意临时串的 GC 开销。

string

返回：见说明

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

幂尔框架 · 实战干货 · 接口调用

烟幕弹：放一颗烟雾金蝉脱壳

跺地震波：一圈圈踉跄往外推

推箱谜题：一步走错全盘僵

星轨接电：转一转接亮满天星

龙卷风：把怪全卷进风眼里

斩钢一闪：穿身而过的刀痕