Redis 原子保种的实现示例

 更新时间:2026年03月31日 10:33:22   作者:Leon_Jinhai_Sun  
本文主要介绍了Redis 原子保种的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧

功能一句话概括:
“确保 Redis 里存在该 key,且其 TTL ≥ 60 s,否则用 setnx 写入初始 seed 并把过期时间设为 5 min。”

据此可取名:ensure_seed_with_ttl

下面给出完整封装(含类型提示、日志英文、异常兜底),并给出两处可优化点及优化后的代码。

一、原始逻辑直接封装

import datetime
import logging
from typing import Optional
log = logging.getLogger(__name__)
def ensure_seed_with_ttl(
    rediz,
    redis_key: str,
    item_type,
    msg: Optional[str] = None,
) -> None:
    """
    Ensure the Redis key exists and has a TTL of at least 60 s.
    If the key does not exist, atomically set it to the initial seed
    and give it a 5-minute expiration.
    """
    if not rediz.exists(redis_key):
        seed = ensure_seed_reference(item_type)
        result = rediz.setnx(redis_key, seed.ref_seq)
        log.info(
            "Seed ensured in Redis: result=%s, next_seq=%s, msg=%s",
            result, seed.ref_seq, msg
        )
    ttl = rediz.ttl(redis_key)
    if ttl < 60 or ttl == -1:          # -1 表示 key 存在但没有过期时间
        rediz.expire(redis_key, datetime.timedelta(minutes=5))

二、可优化的两点

  1. 竞争窗口
    两个客户端可能同时通过 exists 判断为 False,然后都执行 setnx,虽然 setnx 本身是原子性的,但日志会打印两次“Seed ensured …”,容易误导。
    优化:把“判存在 + 设值 + 设过期”做成一条原子事务(Lua 脚本或 Redis pipeline)。

  2. 减少一次 TTL 查询
    如果 setnx 成功,我们可以直接把过期时间设为 5 min,省去一次 ttl 查询;
    只有 setnx 失败(key 已存在)时才需要 ttl 检查。

三、优化后代码(Lua 脚本一次原子执行)

import datetime
import logging
from typing import Optional
log = logging.getLogger(__name__)
# Lua 脚本:如果 key 不存在,则 set value 并设置 5 min 过期;
# 如果 key 已存在但 ttl<60,则延长到 5 min;
# 返回 1 表示写入了新 seed,返回 0 表示仅调整过期时间。
_ENSURE_SEED_LUA = """
local key, value, min_ttl, full_ttl = KEYS[1], ARGV[1], tonumber(ARGV[2]), tonumber(ARGV[3])
local exists = redis.call('exists', key)
if exists == 0 then
    redis.call('setnx', key, value)
    redis.call('expire', key, full_ttl)
    return 1
else
    local ttl = redis.call('ttl', key)
    if ttl < min_ttl then
        redis.call('expire', key, full_ttl)
    end
    return 0
end
"""
def ensure_seed_with_ttl(
    rediz,
    redis_key: str,
    item_type,
    msg: Optional[str] = None,
) -> None:
    """
    Atomically ensure the Redis key exists and has a TTL of at least 60 s.
    If the key does not exist, atomically set it to the initial seed
    and give it a 5-minute expiration.
    """
    seed = ensure_seed_reference(item_type)
    written = rediz.eval(
        _ENSURE_SEED_LUA,
        1,                      # number of keys
        redis_key,
        seed.ref_seq,           # ARGV[1]
        60,                     # ARGV[2]  min_ttl
        int(datetime.timedelta(minutes=5).total_seconds())  # ARGV[3]  full_ttl
    )
    if written == 1:
        log.info(
            "Seed ensured in Redis: next_seq=%s, msg=%s",
            seed.ref_seq, msg
        )

优化效果

  • 竞争窗口消失,全程原子;
  • 减少一次 ttl 网络往返(在 key 不存在场景);
  • 日志只在真正写入 seed 时打印一次,避免重复误导。

到此这篇关于Redis 原子保种的实现示例的文章就介绍到这了,更多相关Redis 原子保种内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 浅谈Redis中的内存淘汰策略和过期键删除策略

    浅谈Redis中的内存淘汰策略和过期键删除策略

    本文主要介绍了浅谈Redis中的内存淘汰策略和过期键删除策略,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-09-09
  • Redis获取某个大key值的脚本实例

    Redis获取某个大key值的脚本实例

    这篇文章主要给大家分享介绍了关于Redis获取某个大key值的一个脚本实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2018-04-04
  • Redis 命令详解与实战案例

    Redis 命令详解与实战案例

    本文详细介绍了Redis的基础知识、核心数据结构与命令、高级功能与命令、最佳实践与性能优化,以及实战应用场景,通过实战案例,展示了如何使用Redis构建高性能应用系统,感兴趣的朋友跟随小编一起看看吧
    2025-11-11
  • Redis使用Bitmap的方法实现

    Redis使用Bitmap的方法实现

    本文主要介绍了Redis使用Bitmap的方法实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2023-01-01
  • 使用Redis实现记录访问次数的三种方案

    使用Redis实现记录访问次数的三种方案

    这篇文章主要介绍了使用Redis实现记录访问次数的三种方案,文中通过代码示例和图文讲解的非常详细,对大家的学习或工作有一定的帮助,需要的朋友可以参考下
    2024-09-09
  • Redis集群利用Redisson实现分布式锁方式

    Redis集群利用Redisson实现分布式锁方式

    这篇文章主要介绍了Redis集群利用Redisson实现分布式锁方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-05-05
  • Redis实现分布式Session管理的机制详解

    Redis实现分布式Session管理的机制详解

    这篇文章主要介绍了Redis实现分布式Session管理的机制详解,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-01-01
  • 使用Redis获取数据转json,解决动态泛型传参的问题

    使用Redis获取数据转json,解决动态泛型传参的问题

    这篇文章主要介绍了使用Redis获取数据转json,解决动态泛型传参的问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-07-07
  • Linux服务器安装redis数据库图文教程

    Linux服务器安装redis数据库图文教程

    Redis是一个开源的使用ANSI C语言编写、遵守BSD协议、支持网络、可基于内存亦可持久化的日志型、Key-Value数据库,并提供多种语言的API。这篇文章主要介绍了Linux服务器安装redis数据库图文教程,需要的朋友可以参考下
    2018-03-03
  • YII2框架手动安装Redis扩展的过程

    YII2框架手动安装Redis扩展的过程

    这篇文章主要介绍了YII2框架手动安装Redis扩展的过程,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-06-06

最新评论