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

为什么不能直接用 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 为例):
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 最简最安全。


















