【数据存储】限时道具的到期处理：过期提醒与自动回收实现

实战应用：用在哪里

限时时装、限时坐骑、增益卡、活动兑换券——限时道具的到期处理直接影响付费体验：到期无提醒会引发客诉，到期不回收会被无限白嫖。到期系统需要三个组件：到期检测（惰性比对加定时扫描双通道）、到期前提醒（24 小时与 1 小时两档通知）、到期处理（失效加图标置灰）。

到期检测：读取时惰性比对

local function checkExpired(item)
    if not item.expireAt then return false end
    if os.time() >= item.expireAt then
        item.expired = true
        onItemExpired(item)                 -- 触发回收与通知
        return true
    end
    return false
end

-- 背包读取入口统一调用，玩家打开背包即触发过期检查

惰性比对把过期判定分散到每次读取，不需要后台扫描全部玩家的背包。配合每日定时扫描兜底（覆盖长期不登录玩家的道具），两层通道互补。

到期前提醒的两档通知

24 小时与 1 小时各推一条提醒（走邮件与客户端飘字双通道），提醒的标志位记录在道具数据上防止重复推送。限时道具的来源（商城购买、活动兑换）记录在道具属性里，到期回收时按来源区分处理：付费购买的限时道具到期后保留外观收藏（不可用但可见），活动兑换的直接清除。

到期后的三步处理

到期道具的三步处理：第一步标记 expired 置位（图标置灰、tooltip 显示已过期）；第二步从生效计算中剔除（属性加成、外观挂载全部移除）；第三步写流水记录（道具 id、玩家、到期时间、处理方式）。三步走完，限时道具的生命周期闭环，客诉的每一个问题都有日志可查。限时道具的提醒与回收逻辑是付费体验的守门员，这套流程配置化后（提醒档位、回收策略可配），不同类型的限时道具可以有不同的到期策略。

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