讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

updream

一键生成高质量推广成片

剧云
剧云

中文短剧剧本制作平台

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

冬杰吖_3335

冬杰吖_3335

发布时间:2026-04-20 16:53:11

|

980人浏览过

|

来源于php中文网

原创

不能直接用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 脚本示例与调用方式

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

Sentinal Redis
Sentinal Redis

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

下载
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 为例):

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 最简最安全。

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

笔灵降AI

一款AI论文写作工具,主要用于论文降AI神器,适配知网及维普!一键降至安全线,100%保留原文格式;无口语化问题,文风更学术,降后字数控制最佳!,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

相关专题

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

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

2233

2023.08.11

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

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

3794

2023.10.07

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

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

5029

2023.11.02

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

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

4615

2023.11.14

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

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

9032

2024.04.02

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

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

683

2024.04.07

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

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

776

2024.04.07

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

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

9482

2024.04.07

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

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

精品课程

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn