CHUAN2 DEV ENGINE
996 正版授权研发中心 · 360 授权合作教学中心 · 抖音传奇直播合作授权 · 快手推广运营商授权
OFFICIAL LICENSED ACADEMY 查验官方授权证书 →
// 威海旷世互娱教学基地 · 技术文章
进阶实战996引擎幂等消费消息去重

【进阶实战】幂等消费:消息重复投递的防护封装

2026-09-25 04:16 作者:996 技术组 0 阅读 996引擎Lua教程传奇脚本进阶实战996引擎Lua幂等消费消息去重

业务场景

消息队列的投递语义是"至少一次":网络抖动时同一条奖励消息可能投递两次,消费端不设防就给玩家发两份奖励。幂等消费封装:每条消息带唯一键,消费端维护去重表,重复键直接跳过;处理成功才记录键,处理失败不记键让消息重投——重复不重复发、失败不吞单,两头都要保。

核心实现

去重表与幂等消费:键查重、处理成功落键。示例代码如下:

lua
local dedup = {}
local TTL = 7 * 86400
local function isDuplicate(msgId)
    local e = dedup[msgId]
    if e == nil then
        return false
    end
    if os.time() - e.ts > TTL then
        dedup[msgId] = nil
        return false
    end
    return true
end
local function consume(msg)
    if isDuplicate(msg.id) then
        print("重复消息 " .. msg.id .. ",跳过")
        return true
    end
    deliverReward(msg)
    dedup[msg.id] = { ts = os.time() }
    return true
end
local function deliverReward(msg)
    giveitem(getplayerbyname(msg.to), msg.item, msg.num, 0, "活动奖励")
end

去重表过期清理示例代码如下:

lua
local function purgeDedup()
    local now = os.time()
    for k, e in pairs(dedup) do
        if now - e.ts > TTL then
            dedup[k] = nil
        end
    end
end

接口拆解

consume 的顺序是"查重、处理、落键":处理成功才落键,处理抛错不落键,消息重投时还能再处理一次——这是"至少一次加幂等"组合的标准姿势。去重键用消息自带的消息号而非内容哈希,跨服务生成键的口径统一由发送方负责。TTL 7 天覆盖重投窗口,purgeDedup 周期清理防表膨胀。

踩坑记录

幂等消费踩过三个坑:一是"先落键后处理"的顺序在处理失败时把消息永久标记为已消费,奖励丢失且不会重投——顺序必须处理成功再落键;二是去重键由各服务自己生成,两个服务对同一笔业务生成了不同键,去重失效,键的生成规则收口到消息发送方;三是去重表没有清理机制,三个月膨胀到百万条拖慢查询,TTL 加周期清理是标配。

作者履历与出处

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

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

最新技术文章 · 实战干货

LATEST ARTICLES

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

策划架构996引擎

【策划架构】Lua脱敏显示:行会名单的星号打码规则

一、抛坑提问:名单展示要给隐私留余地,"裁决之杖"持有者的名字怎么打码?保留首尾字符中间换星,长度自适应,规则统一进一个函数…

2026-09-26 08:43 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】Lua拓扑排序:祖玛教主上线脚本的依赖排程

一、一行代码拆解:DEG[dep] = (DEG[dep] or 0) + 1 —— 这一行统计每个脚本被依赖的入度:入度清…

2026-09-26 08:43 996 技术组 · 0 阅读
高级技巧996引擎

【高级技巧】Lua Top-K:沙巴克战力榜前10的线性筛选

一、隐蔽陷阱:5000 人里选前 10,全量 sort 再取头——n log n 白花;只要前 K 名时,维护一张 K 大小…

2026-09-26 08:43 996 技术组 · 0 阅读
策划架构996引擎

【策划架构】Lua哈希分片:沙巴克5000名玩家状态的分桶拆表

一、线上事故:全服 5000 名玩家状态挤一张大表,pairs 巡检一遍 5000 项耗时 120 毫秒,撞上主循环就是一次…

2026-09-26 08:43 996 技术组 · 0 阅读
进阶实战996引擎

【进阶实战】Lua环检测:装备继承链的死循环防护

一、线上事故:装备合成链 A 吃 B、B 吃 A,合成脚本顺着链找源头,死循环 8 万次后栈爆,M2 卡死 40 秒;数据带…

2026-09-26 08:43 996 技术组 · 0 阅读
入门夯实996引擎

【入门夯实】Lua相对时间:祖玛教主战报的人性化时刻

一、抛坑提问:战报里直接写 os.time() 的原始秒数 1758849600,谁能看懂?按"3 分钟前""2 小时前"分…

2026-09-26 08:43 996 技术组 · 0 阅读