tech-redisson-spring-data-redis-compat.md 1.6 KB
Redisson 与 Spring Data Redis 版本兼容
来源：变更 fix-redisson-spring-data-35 时间：2026-06-27
问题描述
Spring Boot 3.5.x（Spring Data Redis 3.5）环境下，/auth/login 登录报 StackOverflowError。
根因：Spring Data Redis 3.5 的 RedisKeyCommands 新增了 pExpire(byte[], Expiration, ExpirationOptions) 签名。旧版 Redisson（3.34.1）依赖的 redisson-spring-data-33 适配层没有实现该新签名，导致接口的 default 方法与 Redisson 旧方法之间互相递归调用，最终栈溢出。
解决方案
- Redisson 的 Spring Data 适配是按 Spring Data Redis 主版本分模块的：
redisson-spring-data-33（3.3.x）、redisson-spring-data-35（3.5.x）等。Redisson 主版本必须与 Spring Data Redis 主版本对齐。 - 修复只需升级版本管理：
redisson.version从3.34.1→3.50.0，redisson-spring-boot-starter即解析到redisson-spring-data-35，与 Spring Data Redis 3.5.x 签名匹配。 - 两处 POM 必须同步：
forge-server/pom.xml与forge-server/forge-framework/forge-dependencies/pom.xml。 - 验证手段（无需启动服务）：
bash mvn -pl forge-framework/forge-starter-parent/forge-starter-cache -am \ dependency:tree -Dincludes=org.redisson -DskipTests确认依赖树解析到redisson-spring-data-35而非-33。 - 回退方式：还原两个 POM 的
redisson.version，或换用其他包含redisson-spring-data-35的 Redisson 版本。
相关文件
forge-server/pom.xmlforge-server/forge-framework/forge-dependencies/pom.xml- 踩坑记录已追加到
code-copilot/memory/pitfalls.md