不能直接用redisTemplate.opsForValue().increment()生成跨服务分布式ID,因其仅返回单调递增数字,缺乏服务端时间戳、实例标识,且不防时钟回拨;需用Lua脚本原子执行TIME+INCR+EXPIRE,并动态嵌入实例标识以保障全局唯一与大致有序。

不能直接用 redisTemplate.opsForValue().increment() 生成跨服务可用的分布式 ID——它只返回单调递增数字,不带时间戳、无实例标识、不防时钟回拨,扩缩容或主从切换后极易乱序甚至重复。
为什么 INCR 单独调用在跨服务场景下必然出问题
常见错误是把客户端生成的时间戳 + INCR 拼接成 ID。这会立刻暴露三个硬伤:
- 客户端时间不准或网络延迟,导致多个服务在同一毫秒内拿到相同时间戳,再各自
INCR,拼出的 ID 可能重复(比如都生成了17293824000000001) -
INCR的 key 如果按毫秒级构造(如id:seq:1729382400000),不加EXPIRE,一天就产生 8640 万 key,Redis 内存很快打满 - 没嵌入实例标识(如 IP 或 service name),新扩容的服务从 0 开始计数,ID 失去“大致有序”特性,分库分表路由和日志排查全乱
必须用 Lua 脚本在 Redis 端原子获取服务端时间 + 自增 + 过期
关键不是“能不能用 Redis”,而是“怎么用”。必须让时间戳、INCR、EXPIRE 全部在 Redis 服务端一次执行,杜绝竞态。核心逻辑只有四行:
local ts = math.floor(tonumber(redis.call('TIME')[1]) * 1000 + tonumber(redis.call('TIME')[2]) / 1000)
local key = 'id:seq:' .. math.floor(ts / 1000)
local seq = redis.call('INCR', key)
redis.call('EXPIRE', key, 86400)
return ts * 10000 + seq
注意点:
-
TIME返回的是 Redis 服务端的秒+微秒,比任何客户端时间都可靠 - key 按秒级构造(
math.floor(ts / 1000)),不是毫秒级,大幅降低 key 数量 -
EXPIRE 86400必须写,否则 key 永久残留;别信“自动过期”这种模糊说法 - 返回值乘以
10000是预留 4 位序列号空间,单秒最多支持 9999 个 ID,够用且不溢出 long
RedisTemplate.execute() 调用 Lua 的三个致命细节
Spring Boot 默认配置下,execute() 很容易静默失败或类型转换报错:
- 别用
StringRedisTemplate直接execute()—— 它默认把返回值当String反序列化,而脚本返回的是数字,必抛ClassCastException - 必须显式传入
RedisScript,并设置setValueSerializer(new GenericToStringSerializer(Long.class)),否则反序列化失败 - 集群模式下,key 必须落在同一 slot;脚本里所有 key 都要通过
KEYS[1]传入,不能硬编码,否则报NOSCRIPT
最易被忽略的一点:跨服务 ID 的“实例标识”不能靠客户端传,也不能写死,得从 Spring Environment 或 InetAddress.getLocalHost() 动态读取,并混入最终 ID(比如左移 10 位再或上),否则服务重启或容器漂移后,ID 序列就断层了。











