Spring Boot 一个依赖搞定 session 共享，没有比这更简单的方案了！

有的人可能会觉得题目有点夸张，其实不夸张，题目没有使用任何修辞手法！认真读完本文，你就知道gblfy说的是对的了！

文章目录

一、背景
二、分析思路
三、实战
- 1. 创建工程
- 2. pom.xml
- 3. redis配置
- 4. 使用
- 5. 项目打包
- 6. 启动项目的两个实例
- 7. 浏览器验证
- 8. redis变量查询
- 9. 获取8080的服务
二、Nginx加入
- 2.0. nginx安装
- 2.1. 修改配置文件
- 2.2. 配置说明
- 2.3. 上传项目jar到linux服务器
- 2.3. 启动两个 Spring Boot 实例
三、验证
- 3.1. 启动Nginx
- 3.2. 手动清除 Redis 上的数据
- 3.3. 浏览器访问保存数据到session中
- 3.4. 再访问 /get 请求
- 3.5. 总结
- 3.6. 本文源码地址

一、背景

在传统的单服务架构中，一般来说，只有一个服务器，那么不存在 Session 共享问题，但是在分布式/集群项目中，Session 共享则是一个必须面对的问题，先看一个简单的架构图：

在这样的架构中，会出现一些单服务中不存在的问题，例如客户端发起一个请求，这个请求到达 Nginx 上之后，被 Nginx 转发到 Tomcat A 上，然后在 Tomcat A 上往 session 中保存了一份数据，下次又来一个请求，这个请求被转发到 Tomcat B 上，此时再去 Session 中获取数据，发现没有之前的数据。对于这一类问题的解决，思路很简单，就是将各个服务之间需要共享的数据，保存到一个公共的地方（主流方案就是 Redis）

二、分析思路

当所有 Tomcat 需要往 Session 中写数据时，都往 Redis 中写，当所有 Tomcat 需要读数据时，都从 Redis 中读。这样，不同的服务就可以使用相同的 Session 数据了。

这样的方案，可以由开发者手动实现，即手动往 Redis 中存储数据，手动从 Redis 中读取数据，相当于使用一些 Redis 客户端工具来实现这样的功能，毫无疑问，手动实现工作量还是蛮大的。

一个简化的方案就是使用 Spring Session 来实现这一功能，Spring Session 就是使用 Spring 中的代理过滤器，将所有的 Session 操作拦截下来，自动的将数据同步到 Redis 中，或者自动的从 Redis 中读取数据。

对于开发者来说，所有关于 Session 同步的操作都是透明的，开发者使用 Spring Session，一旦配置完成后，具体的用法就像使用一个普通的 Session 一样。

三、实战

1. 创建工程

首先创建一个 Spring Boot 工程，引入 Web、Spring Session 以及 Redis:

2. pom.xml

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

注意：
这里我使用的 Spring Boot 版本是2.2.2.RELEASE ，如果使用低版 2.1.4.RELEASE 的话，可以不添加 Spring Security 依赖

3. redis配置

spring:redis:host: 192.168.43.122port: 6379password:database: 0

这里的 Redis ，我虽然配置了四行，但是考虑到端口默认就是 6379 ，database 默认就是 0，所以真正要配置的，其实就是两行。

4. 使用

配置完成后，就可以使用 Spring Session 了，其实就是使用普通的 HttpSession ，其他的 Session 同步到 Redis 等操作，框架已经自动帮你完成了：

/*** @author gblfy* @Description https://www.gblfy.com* @Date 2019/12/8 15:45*/
@RestController
public class HelloController {@Value("${server.port}")Integer port;@GetMapping("/set")public String set(HttpSession session) {session.setAttribute("user", "gblfy");return String.valueOf(port);}@GetMapping("/get")public String get(HttpSession session) {return session.getAttribute("user") + ":" + port;}
}

考虑到一会 Spring Boot 将以集群的方式启动，为了获取每一个请求到底是哪一个 Spring Boot 提供的服务，需要在每次请求时返回当前服务的端口号，因此这里我注入了 server.port 。

5. 项目打包

6. 启动项目的两个实例

java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8080
java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8081

7. 浏览器验证

先访问 localhost:8080/set 向 8080 这个服务的 Session 中保存一个变量，访问完成后，数据就已经自动同步到 Redis 中了：

8. redis变量查询

9. 获取8080的服务

再调用 localhost:8081/get 接口，就可以获取到 8080 服务的 session 中的数据：

此时关于 session 共享的配置就已经全部完成了，session 共享的效果我们已经看到了，但是每次访问都是我自己手动切换服务实例，因此，接下来我们来引入 Nginx ，实现服务实例自动切换。

二、Nginx加入

2.0. nginx安装

https://gblfy.blog.csdn.net/article/details/103447161

2.1. 修改配置文件

很简单，进入 Nginx 的安装目录的 conf 目录下（默认是在 /usr/local/nginx/conf），编辑 nginx.conf 文件:

upstream gblfy.cn{server 127.0.0.1:8080 weight=1;server 127.0.0.1:8081 weight=2;}server {listen       80;server_name  localhost;#charset koi8-r;#access_log  logs/host.access.log  main;location / {proxy_pass http://gblfy.cn;proxy_redirect default;#root   html;#index  index.html index.htm;}

2.2. 配置说明

标签	说明
upstream	表示配置上游服务器，做负载用
gblfy.cn	表示服务器集群的名字，这个可以随意取名字
upstream	里边配置的是一个个的单独服务，相当于一个tomcat
weight	表示服务的权重，意味者将有多少比例的请求从 Nginx 上转发到该服务上
location 中的 proxy_pass	表示请求转发的地址
/	表示拦截到所有的请求，转发转发到刚刚配置好的服务集群中
proxy_redirect	表示设置当发生重定向请求时，nginx 自动修正响应头数据（默认是 Tomcat 返回重定向，此时重定向的地址是 Tomcat 的地址，我们需要将之修改使之成为 Nginx 的地址

2.3. 上传项目jar到linux服务器

配置完成后，将本地的 Spring Boot 打包好的 jar 上传到 Linux
略

2.3. 启动两个 Spring Boot 实例

然后在 Linux 上分别启动两个 Spring Boot 实例：

nohup java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8080 &
nohup java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8081 &

标签	说明
nohup	表示当终端关闭时，Spring Boot 不要停止运行
&	表示让 Spring Boot 在后台启动

注意：如果加入了spring-boot-starter-security依赖，建议使用下面启动，因为启动时会生成spring-boot-starter-security登录密码，等会需要用。

java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8080
java -jar springboot2-session-share-0.0.1-SNAPSHOT.jar --server.port=8081

用户名默认:user

三、验证

预判：Nginx 启动成功后，我们首先手动清除 Redis 上的数据，然后访问 192.168.66.128/set 表示向 session中保存数据，这个请求首先会到达 Nginx 上，再由 Nginx 转发给某一个 SpringBoot 实例

3.1. 启动Nginx

cd /usr/local/nginx/sbin/./nginx

3.2. 手动清除 Redis 上的数据

3.3. 浏览器访问保存数据到session中

如上，表示端口为 8081 的 SpringBoot 处理了这个 /set 请求

3.4. 再访问 /get 请求

可以看到， /get 请求是被端口为 8080 的服务所处理的

3.5. 总结

本文主要向大家介绍了 Spring Session 的使用，另外也涉及到一些 Nginx 的使用，虽然本文较长，但是实际上 Spring Session 的配置没啥。

我们写了一些代码，也做了一些配置，但是全都和 Spring Session 无关，配置是配置 Redis，代码就是普通的 HttpSession，和 Spring Session 没有任何关系！

唯一和 Spring Session 相关的，可能就是我在一开始引入了 Spring Session 的依赖吧！

如果大家没有在 SSM 架构中用过 Spring Session ，可能不太好理解我们在 Spring Boot 中使用 Spring Session 有多么方便，因为在 SSM 架构中，Spring Session 的使用要配置三个地方，一个是 web.xml 配置代理过滤器，然后在 Spring 容器中配置 Redis，最后再配置 Spring Session，步骤还是有些繁琐的，而 Spring Boot 中直接帮我们省去了这些繁琐的步骤！不用再去配置 Spring Session。

好了，本文就说到这里，有问题欢迎留言讨论，本文相关案例我已经上传到码云，大家可以自行下载。

3.6. 本文源码地址

https://gitee.com/gb_90/SpringBoot2_Practical_Column