本文介绍如何通过 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 = 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 的原子性封装逻辑，是简洁、可靠且高性能的工程实践。