noclassdeffounderror 报 redis 启动失败主因是缺失底层依赖：commons-pool2（lettuce 所需）、fst（redisson 所需）或 netty；需据报错类全限定名精准引入对应依赖，且版本须与 spring boot bom 对齐。
直接结论：绝大多数 NoClassDefFoundError 报 Redis 启动失败，不是 Redis 配置写错了，而是缺了底层依赖——最常见的是 commons-pool2，其次是 netty 或 fst（用 Redisson 时）。
为什么启动就报 NoClassDefFoundError: org/apache/commons/pool2/impl/GenericObjectPoolConfig？
Spring Boot 2.7+ 把 commons-pool2 设为 <optional>true</optional>，Maven 不再自动拉它。但 Lettuce 连接池默认需要这个类，一启动就炸。
- 不是你代码写错，也不是 Redis 地址配错，是 classpath 里根本没这个 jar
- 检查方式：打开
mvn dependency:tree输出，搜commons-pool2，如果没出现或显示omitted for conflict，就是缺了 - 别试图降级 Spring Boot 或手动指定旧版
spring-data-redis——这会触发NoSuchMethodError，更难排查
怎么加 commons-pool2 才不踩坑？
必须显式声明，且版本要跟 Spring Boot 对齐（不用写版本号，靠父 POM 管）。
Redis 8.2.3
下载
Redis 8.2.3 是一款安全优先的高性能键值存储系统。该版本紧急修复了可能引发远程代码执行（RCE）的高危漏洞（CVE-2025-62507），并解决了 HyperLogLog 及 Cuckoo Filter 等数据结构在特定场景下的崩溃问题。建议所有用户立即升级，以保障生产环境的系统稳定与数据安全。
- 在
pom.xml里紧挨着spring-boot-starter-data-redis下面加： <dependency><groupid>org.apache.commons</groupid><artifactid>commons-pool2</artifactid></dependency>
- Gradle 用户写：
implementation 'org.apache.commons:commons-pool2' - 不要写
<version></version>——Spring Boot 的spring-boot-dependenciesBOM 已锁定兼容版本，硬写反而容易冲突
用了 Redisson 却报 NoClassDefFoundError: Lorg/nustaq/serialization/FSTConfiguration 怎么办？
这是 Redisson 默认序列化器 FST 缺依赖，和 Lettuce 完全无关，不能靠加 commons-pool2 解决。
- 加
fst依赖即可，版本用2.57（兼容 JDK 8–17，且与主流 Redisson 版本匹配） <dependency><groupid>de.ruedigermoeller</groupid><artifactid>fst</artifactid><version>2.57</version></dependency>
- 如果你不想用 FST，改用
JsonJacksonCodec或FstCodec（需额外配置），但加fst是最省事的路径 - 注意：FST 不是可选依赖，Redisson 的 class 文件里直接引用了它，缺了必报
NoClassDefFoundError
真正麻烦的从来不是配置本身，而是错误堆栈里那个类名——GenericObjectPoolConfig 指向 commons-pool2，FSTConfiguration 指向 fst，NettyChannelHandler 就得查 netty-handler。盯着报错类的全限定名找依赖，比猜“是不是配置不对”快十倍。
