手把手教你用SpringBoot+Redis实现分布式Session共享

🎓博主介绍：Java、Python、js全栈开发 “多面手”，精通多种编程语言和技术，痴迷于人工智能领域。秉持着对技术的热爱与执着，持续探索创新，愿在此分享交流和学习，与大家共进步。
📖DeepSeek-行业融合之万象视界(附实战案例详解100+)
📖全栈开发环境搭建运行攻略：多语言一站式指南(环境搭建+运行+调试+发布+保姆级详解)
👉感兴趣的可以先收藏起来，希望帮助更多的人

手把手教你用Spring Boot + Redis实现分布式Session共享

一、引言

在分布式系统架构中，传统的单节点应用的 Session 管理方式已无法满足需求。当用户请求在多个服务节点之间流转时，需要保证用户的 Session 信息能够在各个节点间共享，否则会出现用户重复登录等问题。Redis 作为高性能的内存数据库，具有快速读写和持久化等特性，非常适合用于存储分布式环境下的 Session 信息。本文将详细介绍如何使用 Spring Boot 和 Redis 实现分布式 Session 共享。

二、环境准备

2.1 开发环境

确保你已经安装了以下开发环境：

• JDK 1.8 及以上版本
• Maven 3.x
• Redis 服务器（可本地安装或使用云服务）

2.2 新建 Spring Boot 项目

可以使用 Spring Initializr（https://start.spring.io/） 来快速创建一个 Spring Boot 项目，添加以下依赖：

<dependencies>
    <!-- Spring Web -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <!-- Spring Session + Redis -->
    <dependency>
        <groupId>org.springframework.session</groupId>
        <artifactId>spring-session-data-redis</artifactId>
    </dependency>
    <!-- Redis -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-redis</artifactId>
    </dependency>
</dependencies>

三、Redis 配置

3.1 安装和启动 Redis

如果你还没有安装 Redis，可以根据自己的操作系统选择合适的安装方式。安装完成后，启动 Redis 服务器。

3.2 配置 Spring Boot 项目连接 Redis

在 application.properties 或 application.yml 中添加 Redis 连接配置，以 application.yml 为例：

spring:
  redis:
    host: localhost
    port: 6379
    password:  # 如果 Redis 有密码，填写相应密码

四、Spring Session 配置

4.1 启用 Spring Session

在 Spring Boot 主类上添加 @EnableRedisHttpSession 注解，启用基于 Redis 的 HTTP Session 支持：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.session.data.redis.config.annotation.web.http.EnableRedisHttpSession;

@SpringBootApplication
@EnableRedisHttpSession
public class SpringBootRedisSessionApplication {

    public static void main(String[] args) {
        SpringApplication.run(SpringBootRedisSessionApplication.class, args);
    }
}

4.2 配置 Session 相关属性

可以在 application.yml 中配置 Session 的过期时间等属性：

spring:
  session:
    timeout: 1800  # Session 过期时间，单位为秒

五、编写测试接口

5.1 编写控制器

创建一个控制器类，用于测试 Session 的使用：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.servlet.http.HttpSession;

@RestController
public class SessionController {

    @GetMapping("/setSession")
    public String setSession(HttpSession session) {
        session.setAttribute("username", "testUser");
        return "Session 已设置";
    }

    @GetMapping("/getSession")
    public String getSession(HttpSession session) {
        String username = (String) session.getAttribute("username");
        if (username != null) {
            return "Session 中的用户名: " + username;
        } else {
            return "Session 中无用户名信息";
        }
    }
}

5.2 测试接口

启动 Spring Boot 项目，使用浏览器或工具（如 Postman）访问以下接口：

• 访问 http://localhost:8080/setSession，设置 Session 信息。
• 访问 http://localhost:8080/getSession，获取 Session 信息。

六、原理分析

6.1 Spring Session 工作原理

Spring Session 通过过滤器（SessionRepositoryFilter）拦截所有的 HTTP 请求，将原生的 HttpSession 替换为 Spring Session 实现的 Session。当请求到达时，过滤器会从 Redis 中获取 Session 信息，如果不存在则创建一个新的 Session，并将 Session 信息存储到 Redis 中。

6.2 Redis 存储 Session 信息

Redis 中存储的 Session 信息以键值对的形式存在，键的格式通常为 spring:session:sessions:<sessionId>，值包含了 Session 的各种属性和过期时间等信息。

七、分布式环境测试

7.1 部署多个服务实例

将 Spring Boot 项目打包成可执行的 JAR 文件，然后在不同的端口上启动多个服务实例。例如：

java -jar spring-boot-redis-session.jar --server.port=8081
java -jar spring-boot-redis-session.jar --server.port=8082

7.2 测试 Session 共享

使用负载均衡器（如 Nginx）将请求分发到不同的服务实例上。首先访问 http://<负载均衡器地址>/setSession 设置 Session 信息，然后多次访问 http://<负载均衡器地址>/getSession，无论请求被分发到哪个服务实例，都能获取到相同的 Session 信息，说明 Session 共享已经实现。

八、注意事项

8.1 序列化问题

由于 Redis 存储的是二进制数据，因此需要对存储在 Session 中的对象进行序列化。确保存储在 Session 中的对象实现了 java.io.Serializable 接口。

8.2 Redis 高可用

在生产环境中，为了保证 Redis 的高可用性，建议使用 Redis 集群或主从复制等方案。

九、总结

通过本文的介绍，我们详细了解了如何使用 Spring Boot 和 Redis 实现分布式 Session 共享。首先进行了环境准备，包括开发环境的安装和 Spring Boot 项目的创建；然后配置了 Redis 连接和 Spring Session；接着编写了测试接口来验证 Session 的使用；最后进行了分布式环境的测试。希望本文能帮助你在实际项目中顺利实现分布式 Session 共享。