本文介绍如何通过 redis 内置的 lua 脚本机制，安全、原子地实现「仅在键已存在前提下更新其值」的逻辑，彻底规避竞态条件（如过期瞬间的检查-设置失效问题）。
本文介绍如何通过 redis 内置的 lua 脚本机制，安全、原子地实现「仅在键已存在前提下更新其值」的逻辑，彻底规避竞态条件（如过期瞬间的检查-设置失效问题）。
在 Redis 中，不存在原生的 SETIFEXIST 命令，而常见的 SETNX（SET if Not eXists）恰恰与需求相反——它只在键不存在时设置。若业务要求「必须确保键已存在才能更新值」（例如每日库存计数器需先初始化、后续仅允许续存更新），直接使用 GET + EXISTS + SET 多步操作会引发典型的 check-then-act 竞态问题：两次网络往返间，键可能因过期被自动删除，导致后续 SET 失败或误创建新键。
Redis 提供的 Lua 脚本执行是原子性的（单个脚本在服务端串行执行，期间无其他命令插入），这使其成为解决该问题的理想方案。核心思路是：将「判断键是否存在 → 若存在则更新值并重设过期时间」封装为一个 Lua 脚本，在服务端一次性完成，杜绝中间状态干扰。
以下为完整 PHP 实现示例：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
// 初始化脚本：若键不存在，则设初值 + 过期时间；存在则直接返回当前值
$getAndInitLua = <<<LUA
local key = KEYS[1]
local expireAt = ARGV[1]
local value = redis.call('GET', key)
if value == false then
redis.call('SET', key, 100) -- 初始值
redis.call('EXPIREAT', key, expireAt)
return 100
else
return value
end
LUA;
// 更新脚本：强制更新值并刷新过期时间（仅当键存在时生效，因 SET 本身不校验存在性，但 EXPIREAT 对不存在键无效）
$setWithExpireLua = <<<LUA
local key = KEYS[1]
local value = ARGV[1]
local expireAt = ARGV[2]
redis.call('SET', key, value)
redis.call('EXPIREAT', key, expireAt)
LUA;
$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
$expiredAt = strtotime(date('Y-m-d')) + 86400; // 今日结束时间戳（注意：原文中 864000 为 10 天，应为 86400）
$key = "store_of_today";
// 原子化获取/初始化
$left = $redis->eval($getAndInitLua, [$key, $expiredAt], 1);
// ... 业务逻辑处理（如扣减库存）...
$newLeft = max(0, $left - 1);
// 原子化更新：无论键是否刚过期，此脚本均能确保值与过期时间同步刷新
$redis->eval($setWithExpireLua, [$key, $newLeft, $expiredAt], 1);⚠️ 关键注意事项：
- EXPIREAT 对不存在的键静默失败（返回 0），但 SET 会强制创建键。因此 $setWithExpireLua 实际具备「存在则更新+续期，不存在则创建+设期」双重语义。若严格要求「仅更新不创建」，需在脚本中显式检查 EXISTS 并 return：
if redis.call('EXISTS', key) == 0 then return 0 -- 或 error("key not exists") end redis.call('SET', key, value) redis.call('EXPIREAT', key, expireAt) - Lua 脚本中避免耗时操作（如循环大量数据），否则会阻塞 Redis 主线程。
- 时间戳务必使用秒级 UNIX 时间戳（EXPIREAT 参数），PHP 中用 strtotime() 或 DateTime 生成后需验证有效性。
总结：面对「键存在性依赖」的强一致性场景，放弃客户端多步协调，转而利用 Redis Lua 的原子性封装逻辑，是简洁、可靠且高性能的工程实践。
