# 修复登录 Redisson Spring Data 适配死循环
> status: done
> created: 2026-06-24
> complexity: 🟢简单

## 1. 背景与目标

`/auth/login` 登录时报 `StackOverflowError`。初步诊断为 Spring Boot 3.5.13 带来的 Spring Data Redis 3.5 接口变更，与当前 Redisson 3.34.1 依赖的 `redisson-spring-data-33` 不兼容。

Spring Data Redis 3.5 的 `RedisKeyCommands` 新增 `pExpire(byte[], Expiration, ExpirationOptions)` 签名；旧版 Redisson Spring Data 适配层未实现该签名时，会触发接口 default 方法与 Redisson 旧方法之间的递归调用，最终栈溢出。

本变更目标：

- 将 Forge 后端 Redisson 管理版本升级到包含 Spring Data Redis 3.5 适配层的版本。
- 确保 `forge-starter-cache` 不再解析到 `redisson-spring-data-33`。
- 保持变更范围仅限依赖版本管理，不改登录业务逻辑。

## 2. 范围

本期修改：

- `forge-server/pom.xml`
- `forge-server/forge-framework/forge-dependencies/pom.xml`

本期不做：

- 不调整 Spring Boot 版本。
- 不改 Redis、Sa-Token 或登录 Controller/Service 逻辑。
- 不启动依赖本地数据库和 Redis 的完整登录链路。

## 3. 方案

将 `redisson.version` 从 `3.34.1` 升级到 `3.50.0`。该版本的 `redisson-spring-boot-starter` 解析到 `redisson-spring-data-35`，与 Spring Data Redis 3.5.x 的接口签名匹配。

## 4. 风险与回滚

风险：

- Redisson 版本跨度较大，需要关注运行时 Redis 配置兼容性和锁行为。

回滚：

- 如验证发现新的 Redisson 运行时兼容问题，可回退本次两个 POM 中的 `redisson.version`，再选择其他包含 `redisson-spring-data-35` 的 Redisson 版本重试。

## 归档记录（HARD-GATE）
- **状态**：done
- **归档时间**：2026-06-27
- **归档人**：yaomd（批量归档）
- **归档路径**：code-copilot/changes/archive/2026-06-27-fix-redisson-spring-data-35/
- **判定依据**：任务清单全部完成，execution-log 验证通过（编译/构建/lint 闭环）。