Redis怎样在分布式环境中实现自增ID_使用Lua脚本保障唯一性

冬杰吖_3335

冬杰吖_3335

2026-04-20

980人浏览

原创

不能直接用INCR是因为分布式环境下存在跨slot限制或非原子业务逻辑风险;需用Lua脚本保证原子性,且key必须带hash tag(如id_counter:{order})确保同slot,初始化用EXISTS+SET,返回用tonumber(INCR)。

redis怎样在分布式环境中实现自增id_使用lua脚本保障唯一性

为什么不能直接用 INCR?

在单节点 Redis 里,INCR 确实是原子的,能安全生成自增 ID。但分布式环境常指「多个 Redis 实例」(如 Cluster 模式)或「应用多实例 + 单 Redis」——前者 INCR 根本不能跨 slot 执行,后者看似可用,实则隐藏风险:如果业务逻辑在 INCR 后还要做校验、写 DB、发消息等非原子操作,中间失败会导致 ID “已发未用”,产生空洞甚至逻辑错乱。

EVAL 执行 Lua 脚本时的原子性边界

Redis 对单个 EVAL 命令内所有操作保证原子执行,前提是脚本里只操作**同一个 key 所在的 slot**(Cluster 下)。所以必须确保 ID 计数器 key 的 hash tag 固定,比如用 id_counter:{order},让所有相关 key 落在同一 slot。

常见错误是脚本里混用多个 key 且没加 {} 包裹,导致 CROSSSLOT Keys in request don't hash to the same slot 错误。

实操建议:

  • 脚本开头用 local key = KEYS[1] 显式声明操作 key,避免硬编码
  • 需要初始化时,用 if redis.call("EXISTS", key) == 0 then redis.call("SET", key, 0) end,别依赖外部 SETNX
  • 返回值统一用 return tonumber(redis.call("INCR", key)),避免 Lua 类型转换问题

Lua 脚本示例与调用方式

这是生产可用的最小闭环脚本,支持初始化 + 自增 + 返回整数:

local key = KEYS[1]
local init_val = tonumber(ARGV[1]) or 0
if redis.call("EXISTS", key) == 0 then
    redis.call("SET", key, init_val - 1)
end
return tonumber(redis.call("INCR", key))

调用命令(以 Python redis-py 为例):

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载

r.eval(script, 1, "id_counter:{user}", "1000") —— 表示 key 是 id_counter:{user},起始值为 1000(即第一次调用返回 1001)

注意:ARGV[1] 是字符串,必须显式 tonumber();不传 ARGV 时默认从 0 开始。

比 Lua 更稳的替代方案?

如果业务要求 ID 全局严格有序、无空洞、且容忍毫秒级延迟,INCR + Lua 仍是最轻量选择。但要注意:

  • Redis Cluster 下必须用 hash tag 强制路由,否则报错
  • 高并发下大量 EVAL 可能阻塞单个 shard 的其他请求(因 Redis 单线程)
  • 若需时间序 + 唯一性,考虑 Redis Time Series 模块的 TS.ADD 或改用 Snowflake 算法(但需自己维护 workerID)

真正容易被忽略的是:脚本里调用 redis.call("GET", ...) 再判断再 SET,这种“读-改-写”模式在 Lua 里已失去意义——因为整个脚本就是原子的,直接 INCR 最简最安全。

相关专题

更多
什么是分布式
什么是分布式

分布式是一种计算和数据处理的方式,将计算任务或数据分散到多个计算机或节点中进行处理。本专题为大家提供分布式相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2233

5

分布式和微服务的区别
分布式和微服务的区别

分布式和微服务的区别在定义和概念、设计思想、粒度和复杂性、服务边界和自治性、技术栈和部署方式等。本专题为大家提供分布式和微服务相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.07

3794

5

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.02

5029

19

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.14

4615

11

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.02

9032

6

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

683

6

redis怎么解决数据一致性
redis怎么解决数据一致性

redis 提供了两种一致性模型,以维护副本数据一致性:强一致性 (sync) 确保写操作仅在复制到所有从节点后才完成;最终一致性 (async) 则在主节点上写操作后认为已完成,牺牲一致性换取性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

776

6

mysql和redis怎么保证双写一致性
mysql和redis怎么保证双写一致性

确保 mysql 和 redis 双写一致性的技术包括:1、事务性更新:同时更新 mysql 和 redis,保证一致性;2、主从复制:mysql 主服务器更改同步到 redis 从服务器;3、基于事件的更新:mysql 记录更改并发送到 redis等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

9482

6

redis缓存一般存些什么数据
redis缓存一般存些什么数据

redis缓存中存储的数据类型包括:字符串、哈希、列表、集合、有序集合、位图、地理空间数据和hyperloglog。这些数据类型适用于存储各种数据,从简单信息到复杂对象和地理位置。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.07

1200

6

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero官方文档
Go-Zero官方文档

共0课时 | 0人学习