如何解决Spring Boot集成Redis时出现的非法状态异常_排查Redis服务器版本过低-Redis-PHP中文网

spring boot 2.x默认lettuce要求redis服务端≥2.6，低于该版本会因不支持config get等命令抛illegalstateexception；强制切jedis或调连接池参数均无效，必须升级redis服务端并正确配置protected-mode与bind。

如何解决spring boot集成redis时出现的非法状态异常_排查redis服务器版本过低

Redis服务器版本低于2.6会导致IllegalStateException

Spring Boot 2.x+ 默认使用Lettuce客户端，而Lettuce从2.6起才正式支持CLIENT SETNAME和CONFIG GET等命令。若Redis服务端是1.2或2.4这类老版本，启动时会抛出IllegalStateException: Unable to configure RedisConnectionFactory——本质是Lettuce尝试执行不被支持的命令后主动放弃初始化。

用redis-cli --version确认服务端版本（注意不是客户端版本）
在Redis服务器上运行redis-cli info server | grep redis_version获取真实版本号
低于2.6的版本必须升级，2.4.x已停止维护且存在已知协议兼容问题

application.yml里加`client-type=jedis`不能绕过版本限制

有人试图通过强制切换客户端来规避，比如在配置中写spring.redis.client-type=jedis，但这只影响客户端实现，不改变对Redis服务端协议的要求。Jedis 3.0+ 同样依赖CONFIG GET读取maxmemory等参数，老版本Redis仍会触发InvalidProtocolException或静默失败。

Spring Boot Actuator Analyzer

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

下载

Jedis 2.9.x 是最后一个兼容Redis 2.4的稳定版，但Spring Boot 2.3+已不再适配它
强行降级Jedis并排除Lettuce，大概率引发NoClassDefFoundError或序列化异常
真正可行的临时方案只有：升级Redis服务端，或在测试环境用Docker拉一个2.6+镜像

升级Redis时注意`protected-mode`和`bind`配置回滚

很多团队升级Redis后反而连不上，是因为新版默认开启protected-mode yes且bind 127.0.0.1，而旧配置文件里可能注释了这两行。升级后配置未重载，导致服务监听行为突变。

升级后务必检查redis.conf中protected-mode是否仍为no（开发机可接受）
bind行若被新版覆盖回127.0.0.1，远程连接会直接拒绝，需手动改回0.0.0.0或指定网卡IP
改完配置必须执行redis-cli shutdown再redis-server redis.conf，仅kill -HUP不生效

Lettuce连接池超时参数掩盖了真正的版本问题

当看到RedisConnectionFailureException: Unable to connect to 127.0.0.1:6379时，第一反应常是调大lettuce.pool.max-wait或timeout。但其实底层错误早被吞掉——Lettuce在握手阶段发现CONFIG GET返回错误，就直接关闭连接，日志里只留下“connection refused”这种误导性提示。