如何在Spring Boot中利用Redis实现跨服务的分布式ID生成器

胖枫同学_7054

胖枫同学_7054

2026-10-15

923人浏览

原创

不能直接用incr生成全局唯一有序id,因其仅保证单调递增,缺乏时间信息与结构化特征,且存在重启重复、扩缩容乱序、单点故障及无时钟回拨处理等问题。

如何在spring boot中利用redis实现跨服务的分布式id生成器

直接用 INCR 生成 ID 是最常见也最容易翻车的做法——它能保证单调递增,但不能保证全局唯一、有序、可读,更扛不住时钟回拨、服务重启或 Redis 主从切换。跨服务场景下,必须把时间戳、实例标识、毫秒内序列号三者拼装,并靠 Lua 脚本在 Redis 端原子执行。

为什么不能只用 redisTemplate.opsForValue().increment()

这个调用看似简洁,实则埋了三个硬伤:

  • 客户端生成时间戳再传入,网络延迟或本地时钟漂移会导致同一毫秒内多个服务写入相同 key,INCR 会返回不同值,但拼出的 ID 可能重复或乱序
  • 没做 key 过期控制,每毫秒一个 key(如 id:seq:202609051302)长期累积会撑爆内存
  • 没嵌入实例标识(比如机器 IP 或服务名),扩缩容后新实例从 0 开始计数,ID 失去“大致有序”特性,影响分库分表路由和日志排查

必须用 Lua 脚本封装时间戳 + INCR + EXPIRE

Redis 的 TIME 命令返回服务端当前秒和微秒,比客户端时间可靠;Lua 脚本在服务端原子执行,避免竞态。关键逻辑是:

  • 调用 redis.call('TIME') 拿服务端时间,转成毫秒级时间戳
  • 构造 key:比如 id:seq: + math.floor(ts / 1000)(保留到秒,降低 key 数量)
  • 对 key 执行 INCR,再立刻 EXPIRE 86400 秒(一天),防止 key 泛滥
  • 返回值拼装为 ts * 10000 + seq,预留 4 位给序列号(单秒最多 9999 个 ID)

示例脚本(供 redisTemplate.execute() 调用):

Spring Boot Actuator Analyzer
Spring Boot Actuator Analyzer

分析Spring Boot Actuator端点的安全性、健康检查、指标暴露及生产配置——审计信息、健康状态和自定义端点。

下载
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

RedisTemplate 调用 Lua 的三个避坑点

Spring Boot 默认配置下,RedisTemplate 对 Lua 支持不友好,容易报错或返回类型错乱:

  • 别用 StringRedisTemplate 直接执行 Lua —— 它默认返回 String,而脚本返回的是数字,会抛 ClassCastException
  • 必须显式指定 RedisCallback 或用 execute(RedisScript, keys, args) 形式,并确保 script 的 setValueSerializer 能反序列化 Long
  • 若用 Lettuce(Spring Boot 2.3+ 默认),要确认连接工厂已启用 setUseSsl(false) 或正确配置 TLS,否则 EVAL 可能超时静默失败

跨服务 ID 必须带实例标识,不能只靠时间戳

纯时间戳 + 序列号在单实例下够用,但跨服务部署时,多个服务同时写同一个 key(如 id:seq:202609051302),INCR 返回的只是该 key 的全局计数,无法区分来源。解决办法是:

  • key 中加入服务标识:比如 id:seq:order-service:202609051302,但要注意 key 长度和数量爆炸风险
  • 更稳妥的是在最终 ID 里嵌入标识:取本机 IP 后两位或服务名 hash 后 2 字节,左移到高位,例如 (ipHash
  • 如果用 Redisson,直接上 RedissonIdGenerator,它底层用 setnx + 预分配段机制,天然支持多实例,但要注意 allocationSize 别设太大(默认 1000),否则 ID 跳变明显

真正难的不是写脚本,而是让所有服务共享同一套时间基准、key 生命周期策略和溢出兜底逻辑——这些细节一旦不统一,ID 就会在某个凌晨三点开始重复或倒流。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

redis spring boot

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2511

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

457

25

什么是分布式
什么是分布式

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

2023.08.11

2013

5

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

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

2023.10.07

2994

5

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

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

2023.11.02

4449

19

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

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

2023.11.14

3975

11

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

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

2024.04.02

7332

6

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

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

2024.04.07

643

6

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

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

2024.04.07

756

6

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习