Spring Boot 中使用 Spring Session 实现分布式会话共享的核心是将 session 存储从内存迁移至 Redis 等外部存储，通过配置 spring-session-data-redis 依赖、application.yml 中启用 redis 存储类型并设置超时时间，Spring Boot 自动装配 RedisSessionRepository，使多实例共享同一 session 数据，并支持 JSON 序列化与会话事件监听。
在 Spring Boot 项目中使用 Spring Session 实现分布式会话共享，核心是把原本存在内存（如 Tomcat Session）中的 session 数据，迁移到外部存储（如 Redis、JDBC、MongoDB 等），让多个服务实例能读写同一份 session 数据。最常用、最推荐的方式是基于 Redis 的实现。
引入依赖和基础配置
以 Spring Boot 2.7+ 和 Spring Session 3.x 为例（与 Spring Boot 版本对齐）：
- 添加 spring-boot-starter-data-redis 和 spring-session-data-redis
- 确保 Redis 服务可连接（本地或远程），并在 application.yml 中配置 Redis 连接信息
示例配置：
spring:
redis:
host: localhost
port: 6379
database: 0
session:
store-type: redis # 显式启用 Redis 存储（Spring Boot 2.2+ 默认自动推断）
timeout: 1800 # 会话过期时间（秒），默认 30 分钟启用 Spring Session 自动配置
Spring Boot 会自动装配 Redis-backed 的 SessionRepository，但需确保主类或配置类上启用了 session 支持：
立即学习“Java免费学习笔记（深入）”；
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
- 无需额外注解（Spring Boot 2.0+ 自动生效）
- 若手动配置，可加 @EnableSpringHttpSession（仅限非 Boot 环境或自定义场景）
- 确保 Web 应用类型为 Servlet（即使用 spring-boot-starter-web，而非 webflux）
Spring Session 会自动替换容器原生的 HttpSession 实现，所有 HttpServletRequest.getSession() 调用都会返回 Spring Session 包装后的 Session 对象，底层读写 Redis。
验证会话是否真正共享
部署两个相同应用实例（例如端口分别为 8080 和 8081），通过 Nginx 做简单负载均衡：
- 访问 /login 登录，设置 session 属性（如 session.setAttribute("user", "zhangsan")）
- 后续请求被分发到任一实例，都能通过 session.getAttribute("user") 正确取到值
- 用 redis-cli 查看 key：keys "spring:session:sessions:*"，可见 session 数据已存入 Redis
注意：默认 session ID 由 Cookie（名为 SESSION）传递，确保反向代理（如 Nginx）未修改或丢弃该 Cookie。
可选增强：自定义序列化与会话事件
默认使用 JdkSerializationRedisSessionRepository，但 JDK 序列化有安全与兼容性风险。建议切换为 JSON 序列化：
- 添加 spring-session-jdbc 或自行配置 GenericJackson2JsonRedisSerializer
- 注册自定义 RedisTemplate 并指定 value serializer
- 监听会话创建/销毁事件，可注入 SessionCreatedEvent 或 SessionDestroyedEvent 的监听器
例如监听登录成功后更新 Redis 中的用户在线状态，就可在此处扩展逻辑。
