做 Java 后端这些年Redis 基本是绕不开的基础设施而“Java 操作 Redis 客户端”这件事看起来简单实际坑不少。我见过不少同事在客户端选型上纠结半天也见过线上事故出在序列化配置上更见过面试候选人连 Jedis 和 Lettuce 的区别都说不清楚。这篇文章不打算泛泛讲概念而是把我实际用下来的客户端选型、环境搭建、常用操作、序列化配置、分布式锁这些经验完整走一遍适合刚把 Spring Boot 玩熟、准备深入 Redis 的 Java 开发者也适合准备跳槽想系统梳理 Redis 客户端知识点的朋友。1. 客户端选型Jedis、Lettuce、Redisson 到底怎么选遇到 Java 操作 Redis 的场景第一步不是写代码而是选客户端。选错客户端后面全是坑选对了能省掉很多不必要的麻烦。目前主流就三个Jedis、Lettuce、Redisson。我一个个拆开讲讲完你就知道项目里该用谁。1.1 三个主流客户端的基本盘Jedis 是老牌客户端属于直连式每次操作都走一次 TCP 连接连接用完就得关。它的 API 最直观基本就是redis.set(key, value)、redis.get(key)这种写法上手成本几乎为零。但直连模式在高并发下有个天然短板连接数会膨胀对服务端连接压力很大所以一般必须配合连接池使用。Lettuce 是 Spring Boot 2.x 之后默认集成的客户端底层基于 Netty 实现多路复用。简单说就是一条连接可以同时处理多个请求多个线程共享同一个连接不需要像 Jedis 那样频繁创建销毁连接。这意味着同样的并发量下Lettuce 占用的连接资源更少长连接利用率更高也更适合高并发场景。Redisson 相比之下更像一个分布式工具集它不只是操作 Redis 的命令封装而是在 Redis 之上提供了分布式锁、分布式队列、原子计数、限流器、延迟队列这类高阶能力。如果你需要分布式锁Redisson 能让你少写很多底层逻辑它已经把看门狗、自动续期这些细节都处理好了。三个客户端的关系可以这样理解Jedis 是手动挡Lettuce 是自动挡Redisson 是带了一整套工具箱的自动挡 SUV。手动挡让你清楚知道每一步在干什么自动挡省心SUV 则是为了跑更复杂的路况准备的。1.2 选型建议与场景对照很多人选客户端只看名气这不靠谱要结合项目实际。我把典型场景和对应客户端对比整理成了表格方便你直接对照场景推荐客户端原因Spring Boot 项目常规缓存操作Lettuce默认集成省配置支持多路复用高并发场景大量并发读写Lettuce连接复用减少资源开销功能简单想快速调试JedisAPI 简单代码直观需要分布式锁、分布式对象Redisson提供了完整的分布式解决方案老项目维护历史代码是 JedisJedis避免大规模迁移带来的风险新项目从零搭建Lettuce RedissonLettuce 填基础数据访问Redisson 解决复杂分布式需求如果你用的是 Spring Boot 2.x 或者 3.x默认集成的就是 Lettuce。很多人不知道这一点项目里又自己额外引了 Jedis 的依赖导致同样的 Redis 操作走了两套客户端调试的时候一头雾水。我建议的做法是基础缓存操作直接用 Spring Data Redis 封装好的RedisTemplate和StringRedisTemplate底层走 Lettuce需要分布式锁、限流这种高阶能力时再引入 Redisson。这样配置最少代码最干净性能也不差。2. 环境准备从安装 Redis 到可视化客户端写代码之前先把环境搞定。这一步看着简单但新手经常卡住尤其是 Windows 环境。Redis 官方其实不支持 Windows官网只提供 Linux 版本源码包Windows 下的安装包都是微软团队或者社区维护的。明白这一点之后后面很多操作你就知道为什么了。2.1 三种方式本地起一个 Redis开发机上装 Redis 我推荐三种方式按优先级排Docker 方式、Linux 源码编译、Windows 使用社区编译版本。Docker 方式最省心一条命令就完事。这也是我在开发机上用得最多的方式docker run -d --name redis-local \ -p 6379:6379 \ -v /data/redis:/data \ redis:7.2命令跑起来之后可以用docker ps确认容器状态用docker exec -it redis-local redis-cli -a yourpassword ping测一下连通性能返回 PONG 就说明正常。加-a传密码是避免在交互式命令行里输入时被警告。Linux 服务器上装 Redis 更多是编译安装。去官网下载源码包解压后make make install就行。注意编译前确认系统装了 gcc否则会报cc: command not found。我踩过一次装了半天没反应最后发现是服务器精简版镜像没装编译工具链。Windows 下想跑 Redis可以去 GitHub 上看 Redis for Windows 的社区镜像版本或者用 WSL 把 Linux 子系统跑起来再装。WSL 更接近生产环境推荐。不推荐去找那种来路不明的 exe 安装包安全性和版本更新都没保证。2.2 可视化客户端推荐与配置装好 Redis 之后光靠命令行redis-cli操作不方便尤其是看 key、看内存、查看过期时间这些操作用界面更直观。我推荐两个工具。第一个是 Another Redis Desktop Manager简称 ARDM。它跨平台界面简洁性能不错还在持续更新现在已经完全免费。它支持按 pattern 批量删除 key这对清理测试数据特别有用。比如你想把cache:*开头的 key 全部删掉在命令行要写一堆 Lua 脚本用 ARDM 直接筛选后一键删除效率高一个量级。第二个是 Redis Desktop Manager就是网上搜“redis desktop manager下载”出来最多的那个。老牌工具功能完整但新版已经收费了社区版功能有限。如果公司愿意花钱买 License团队协作时用 RDM 的团队管理功能很方便个人开发用 ARDM 就够了。配置连接时几个容易忽略的点Redis 默认只能本机访问远程连不上是正常的要去 Redis 配置文件里把bind改成0.0.0.0或者注释掉然后设置protected-mode no才能被外部访问。这同样也是安全问题测试环境无所谓生产环境千万别这么干最好用云服务商的安全组加白名单。2.3 装好之后必做的三个验证我每装完一个 Redis 环境不管本地还是服务器都会做三件事确认基础配置避免后面写代码时突然踩坑。第一件事是验证密码。Redis 的密码配置在配置文件里的requirepass字段。不设密码虽方便但只要 IP 暴露在公网一晚上就会被扫描器问候无数次。设置密码后命令行操作要加-a可视化客户端要在连接配置里填密码Java 代码连接时也要在spring.redis.password里配好。第二件事是检查持久化配置。Redis 有 RDB 和 AOF 两种持久化方式。RDB 是快照式定时保存AOF 是日志式追加。开发环境无所谓但如果是拿本地环境复现线上问题持久化配置最好和生产保持一致不然查内存爆炸问题时数据结构和生产环境对不上。第三件事是确认 maxmemory 和淘汰策略。线上 Redis 内存被打满的案例太多了我有一回排查一个缓存雪崩问题最后发现根因是maxmemory-policy配成了volatile-lru但所有 key 都没设置过期时间导致内存满了之后一个 key 都不淘汰新写入全部报 OOM 错误。配置文件里确认一下maxmemory是多少、maxmemory-policy是哪种策略比什么都重要。3. Java 操作 Redis 的完整实操环境准备好之后就可以写代码了。这一节我讲最核心的内容依赖怎么引、连接怎么配、五种基本数据类型的操作怎么写得优雅还有连接池的参数怎么调。3.1 依赖引入与基础连接如果你在用 Spring Boot引入依赖其实很简单。Spring Data Redis 把底层客户端封装好了只需要一个 starter。以 Spring Boot 3 为例dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-redis/artifactId /dependency然后在配置文件里指定连接信息spring: data: redis: host: 127.0.0.1 port: 6379 password: yourpassword database: 0 timeout: 3s lettuce: pool: max-active: 16 max-idle: 8 min-idle: 2注意 Spring Boot 3 里包名前缀从spring.redis变成了spring.data.redis网上很多老教程还在用旧的配置方式你照着抄可能发现根本不生效。这种情况拿配置文件去官方文档查一下当前版本对应的属性名最靠谱。说到连接池Lettuce 本身支持多路复用默认情况下不需要连接池也能正常工作。但实际生产环境我建议还是配一个池原因很简单有些特殊场景比如事务操作连接会被独占没有池的话高并发下连接数无法控制容易打满 Redis 服务端的连接上限。min-idle 设置成 2 可以避免流量高峰时临时建连带来的延迟。3.2 五种基本数据类型的操作示例Java 操作 Redis 通常用RedisTemplate或者StringRedisTemplate。StringRedisTemplate是RedisTemplate的特例key 和 value 都固定用 String 序列化适合纯字符串场景。RedisTemplate更通用但序列化配置没做好容易出乱码后面专门讲。String 类型最简单适合存验证码、token、计数等场景stringRedisTemplate.opsForValue().set(code:13800138000, 123456, 5, TimeUnit.MINUTES); String code stringRedisTemplate.opsForValue().get(code:13800138000);Hash 类型适合存对象比如用户信息、商品信息。相比把整个对象序列化成一个 StringHash 的好处是能单独更新某个字段不用把整个对象取出来再放回去stringRedisTemplate.opsForHash().put(user:1001, name, 张三); stringRedisTemplate.opsForHash().put(user:1001, age, 28); String name (String) stringRedisTemplate.opsForHash().get(user:1001, name);List 类型适合做简单的消息队列。不过要注意低并发下用 List 做队列问题不大高并发消费场景建议还是用专业的 MQ比如 RabbitMQ、Kafka毕竟 Redis 的 List 队列没有消息确认机制消费者挂了消息就丢了。这个坑我踩过详见后面的问题排查。stringRedisTemplate.opsForList().leftPush(task:queue, task-1); String task stringRedisTemplate.opsForList().rightPop(task:queue);Set 类型适合去重场景比如记录某个用户访问过的商品天然的 set 特性保证了同一个商品只记录一次stringRedisTemplate.opsForSet().add(user:1001:goods, goods-001); SetString goods stringRedisTemplate.opsForSet().members(user:1001:goods);ZSet 类型带权重适合排行榜场景。比如给商品点赞数排序直接用 ZSet 的 score 字段做权重stringRedisTemplate.opsForZSet().add(goods:ranking, goods-001, 10); stringRedisTemplate.opsForZSet().add(goods:ranking, goods-002, 20); SetString ranking stringRedisTemplate.opsForZSet().reverseRange(goods:ranking, 0, 9);3.3 连接池和生产参数调整连接池的参数不是随便填的要根据业务并发量计算。先说一个基本公式MAX_ACTIVE 业务并发峰值 / 单连接可处理的QPS。如果峰值并发是 1000Lettuce 单连接可处理几千 QPS那max-active设 16 其实都绰绰有余。但如果你用的是 Jedis 那种直连模式max-active就得按并发数走要设置成 200 甚至更多。我建议的起步配置是max-active 16、max-idle 8、min-idle 2、max-wait 3s。把max-wait调小当连接池耗尽时快速失败返回而不是无限排队等待。有一回线上接口突然变慢排查下来就是因为连接池设置过大并且没有设置 max-wait线程全部卡在获取连接上数据库和 Redis 都正常纯粹是线程堆积把服务拖垮了。生产环境还有一个容易忽略的参数timeout。Spring Data Redis 默认的连接超时是 60 秒这个值在生产环境太长了。客户端请求 Redis 如果卡住60 秒才报错用户那边早就超时了。我一般把timeout配成 2-3 秒宁可快速失败也不能让请求长时间挂起。4. 序列化最容易被忽略的大坑如果你用RedisTemplate存一个对象然后去可视化客户端一看发现 key 和 value 全是类似\xac\xed\x00\x05t\x00的乱码恭喜你踩上了序列化的大坑。这个问题我曾经排查了一天后来才知道根因是 JDK 默认序列化在作怪。4.1 乱码到底从哪来Spring Data Redis 的RedisTemplate默认使用 JdkSerializationRedisSerializer 来序列化 key 和 value。JDK 序列化的产物是二进制字节流开头带着版本号不好读也不可读存到 Redis 里就成了你看到的那串乱码。乱码不只是难看的问
