Springboot 开发 -- Redis实现分布式Session

最新推荐文章于 2025-09-13 09:42:02 发布

原创

最新推荐文章于 2025-09-13 09:42:02 发布 · 2.1k 阅读

22 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #redis #分布式

一、引言

在微服务架构和分布式系统中，会话管理（Session Management）成为了一个挑战。传统的基于Servlet容器的会话管理方式在分布式环境下无法有效工作，因为用户请求可能会被分发到不同的服务器上，导致会话数据无法共享。为了解决这个问题，Spring Session提供了一种基于外部存储（如Redis）的会话管理方式，使得会话数据可以在多个服务器之间共享。

二、Spring Session原理

替换HttpSession：Spring Session通过将Servlet容器实现的HttpSession替换为Spring Session，实现了会话数据的外部存储。这样，无论用户请求被分发到哪个服务器，都可以从外部存储中获取到相同的会话数据。
配置类：Spring Session提供了几个关键的配置类，如RedisHttpSessionConfiguration和SpringHttpSessionConfiguration，用于配置Redis作为会话数据的存储后端。
SessionRepositoryFilter：SessionRepositoryFilter是Spring Session的核心组件之一，它负责在请求处理之前和之后与会话存储进行交互，以确保会话数据的正确加载和保存。

三、如何用 Redis 实现分布式 Session？

在分布式系统中，通常会将 Session 存储在 Redis 中来实现分布式 Session，这样就可以在多台服务器之间共享 Session 数据。实现分布式Session通常使用Redis的Hash结构：

用户登录：当用户成功登录后，服务端生成一个唯一的 Session ID（通常是一个随机字符串，如 UUID）。
存储 Session：将用户的会话信息（如用户ID、权限信息等）与 Session ID 关联，并存储在 Redis 中。Redis 使用 Hash 结构来存储这些数据，其中 Session ID 作为 Hash 的 key，用户的会话信息作为 Hash 的 value。
设置 Cookie：将 Session ID 通过 Cookie 发送到客户端浏览器。这样，客户端在每次请求时都会携带这个 Cookie。
请求处理：在客户端的每次请求中，服务端都会检查 Cookie 中的 Session ID。服务端使用这个 ID 从 Redis 中检索对应的 Session 数据。
认证与授权：通过检索到的 Session 数据，服务端可以验证用户的身份，并根据用户的会话信息进行授权。

Session 过期：设置 Session 的过期时间，当用户长时间不活动或者显式退出登录时，服务端会从 Redis 中删除对应的 Session 数据。

四、实战步骤

1. 添加依赖：

在Spring Boot项目中，通过添加spring-boot-starter-data-redis和spring-session-data-redis的依赖，引入Spring Session和Redis的支持。

<dependency>  
    <groupId>org.springframework.boot</groupId>  
    <artifactId>spring-boot-starter-data-redis</artifactId>  
</dependency>  

<dependency>  
    <groupId>org.springframework.session</groupId>  
    <artifactId>spring-session-data-redis</artifactId>  
</dependency>

2. application.yml中配置

server:  
  servlet:  
    session:  
      timeout: 3600 # session 有效期 1小时
  
spring:  
  session:  
    store-type

最低0.47元/天解锁文章