【框架设计】副本重置机制：每日锚点与失败重置的可靠实现

实战应用：用在哪里

副本的重置分两层：每日重置（挑战次数、进度按业务日清零）与失败重置（团灭后回到入口重来）。两层重置混在一起实现是事故高发区——每日锚点没做对会出现"跨天进度残留"，失败重置没做对会出现"重置后奖励重复领"。

每日重置：日期锚点比对

local function checkDailyReset(progress, dungeonId)
    local today = os.date("%Y-%m-%d")
    if progress.date ~= today then
        progress.date = today
        progress.count = 0
        progress.bossKilled = false
        saveProgress(playerId, dungeonId, progress)
        log("DUNGEON_RESET", playerId, dungeonId)
    end
    return progress
end

读取进度时惰性触发重置（比对日期串），不需要定时器全服扫描——每个玩家在自己的读取路径上完成重置，跨天边界的处理天然分散。

失败重置：快照恢复

团灭重置按开启时的快照重建副本：怪物复活、机关复位、进度清零。快照在副本开启时生成（怪物清单、位置、状态），重置时逐项恢复。重置次数上限（如 3 次）计数在副本对象上，超限踢出并进入冷却（冷却期间不可再进）。

奖励防重的三道闸

副本奖励的重复领取是重置机制最危险的事故。三道闸：进度字段置位（已领奖标志）在发放前检查；发放流水唯一键（玩家 id + 副本 id + 日期）数据库层去重；每日重置后进度清零同时清领奖标志。三道闸配合每日锚点，重置类客诉可以压到接近零。副本重置的日志（谁在何时重置了哪个副本）全部留痕，团本运营的每一次操作都有据可查。

重置的触发时机有讲究：惰性重置（玩家读取进度时比对日期）比定时全服扫描更省资源，且不会在凌晨集中触发大量写入。跨天瞬间的边界处理：23:59 开的副本在 00:01 结算，按开启时的日期锚点结算（属于昨天的那次挑战），锚点在副本开启时固化。

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