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 支持：

• 无需额外注解（Spring Boot 2.0+ 自动生效）
• 若手动配置，可加 @EnableSpringHttpSession（仅限非 Boot 环境或自定义场景）
• 确保 Web 应用类型为 Servlet（即使用 spring-boot-starter-web，而非 webflux）

Spring Session 会自动替换容器原生的 HttpSession 实现，所有 HttpServletRequest.getSession() 调用都会返回 Spring Session 包装后的 Session 对象，底层读写 Redis。

Java 接口排错助手

在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。

下载

验证会话是否真正共享

部署两个相同应用实例（例如端口分别为 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 中的用户在线状态，就可在此处扩展逻辑。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南