讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

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

夜宇姑娘_7445

夜宇姑娘_7445

发布时间:2026-11-19 07:28:29

|

154人浏览过

|

来源于php中文网

原创

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

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

不能直接用 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 服务端一次执行,杜绝竞态。核心逻辑只有四行:

Sentinal Redis
Sentinal Redis

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

下载
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<long></long>,并设置 setValueSerializer(new GenericToStringSerializer(Long.class)),否则反序列化失败
  • 集群模式下,key 必须落在同一 slot;脚本里所有 key 都要通过 KEYS[1] 传入,不能硬编码,否则报 NOSCRIPT

最易被忽略的一点:跨服务 ID 的“实例标识”不能靠客户端传,也不能写死,得从 Spring Environment 或 InetAddress.getLocalHost() 动态读取,并混入最终 ID(比如左移 10 位再或上),否则服务重启或容器漂移后,ID 序列就断层了。

热门AI工具

更多
超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

豆包大模型

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

SoundView
SoundView Hot

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

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

WorkBuddy

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

DeepSeek

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

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

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

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

3051

2025.08.06

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

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

537

2026.01.26

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

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

2233

2023.08.11

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

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

3814

2023.10.07

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

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

5049

2023.11.02

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

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

4635

2023.11.14

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

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

9072

2024.04.02

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

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

683

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