如何在SpringBoot中引入spring-session-data-redis依赖使用Redis管理会话的详细步骤

在Spring Boot中，若要将Session持久化存储到Redis，必须引入spring-session-data-redis依赖。仅依赖spring-boot-starter-data-redis或旧版spring-session无法实现这一目标。原因在于：spring-session-data-redis提供了HTTP Session与Redis集成的自动拦截逻辑，而其他依赖只负责连接Redis和操作key-value，并不理解Session的概念。缺少该依赖，Session将默认存储在内存中，导致分布式环境下无法共享。

务必使用spring-session-data-redis，而非spring-boot-starter-data-redis或旧版spring-session。后者不具备自动Session存储能力，缺少它，Session根本不会写入Redis。

为什么只加spring-boot-starter-data-redis不行

简单来说，该starter仅负责让Spring Boot连接Redis并操作key-value，完全不了解HTTP Session。Session管理需要额外的拦截机制——例如在请求进入时从Redis加载Session，响应结束时写回Redis——这些功能由spring-session-data-redis提供。

常见错误现象：

• 应用启动无报错，但redis-cli keys *查不到spring:session:开头的key
• 重启服务后用户仍保持登录（说明Session存储在内存中，未使用Redis）
• 分布式部署下Session无法共享，节点间状态不一致

spring-session-data-redis的依赖写法（Maven）

Spring Boot 2.4+推荐使用以下写法（无需指定版本，由Spring Boot BOM管理）：

  org.springframework.session  spring-session-data-redis

注意点：

• 不要同时引入spring-session（无data-redis后缀）——它是旧版抽象层，与当前Boot版本不兼容
• 不要使用已废弃的spring-boot-starter-redis（1.x时代产物，2.x起已移除）
• 如果项目使用较老的Spring Boot（如2.1.x），需确认spring-session-data-redis版本≥对应Boot版本（例如2.1.x对应2.1.x）

依赖生效后，@EnableRedisHttpSession还要不要加

Spring Boot 2.0+默认启用自动配置，只要classpath包含spring-session-data-redis，且spring.session.store-type=redis（或未显式设为none），就会自动装配Redis-backed Session。

但建议显式加注解，原因：

• 明确表达意图，避免因配置遗漏导致回退到内存Session
• 方便控制参数：@EnableRedisHttpSession(maxInactiveIntervalInSeconds = 1800)比配置文件更直观
• 可配合redisNamespace隔离不同环境的Session key，防止冲突

不加注解时，server.servlet.session.timeout会被忽略；加了之后，maxInactiveIntervalInSeconds才真正生效。

最容易被忽略的一点：序列化要求

spring-session-data-redis默认使用JdkSerializationRedisSerializer，这意味着存入Session的所有对象都必须实现Serializable接口。否则会静默失败（Session写不进Redis，但不报错）。

推荐做法：

• 改用GenericJackson2JsonRedisSerializer（需自定义RedisTemplate bean）
• 确保往HttpSession放入的对象是简单POJO或基本类型，避免塞HttpServletRequest、Connection等不可序列化对象
• 上线前用redis-cli monitor观察是否有SET命令失败，或检查日志中是否出现Cannot serialize类似提示