您现在的位置：程式碼之家 >> 編程語言 > >> Java 程式設計 >> Java 相關知識

Spring Boot + Redis 實現 Session 共享：分布式會話管理完整教程

編輯：Java 相關知識

為什麼需要 Session 共享？

單體應用將 Session 存儲在 JVM 堆內存，水平擴展多實例後，用戶請求被負載均衡分發到不同實例，導致「登入狀態丟失、購物車清空」。解決方案：將 Session 外部化至 Redis，所有實例讀寫同一份數據。

技術棧版本

Spring Boot 2.x / 3.x
Spring Session Data Redis
Redis 5+（支援 Cluster/Sentinel）

三步接入

1. 引入依賴

<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. 啟用 Redis HttpSession

3. 配置 Redis 連線

# application.yml
spring:
  redis:
    host: localhost
    port: 6379
    password: your_password  # 生產環境必須
    database: 0
    lettuce:
      pool:
        max-active: 20
        max-idle: 10
        min-idle: 5
  session:
    store-type: redis
    redis:
      namespace: "spring:session" # 隔離多應用
      flush-mode: on_save       # 僅屬性變更時寫入
      save-mode: on_set_attribute

驗證 Session 共享效果

啟動兩個實例（端口 8080、9090），同一瀏覽器訪問：

測試步驟與預期

訪問 localhost:8080/demo/put → 返回 {"sessionId":"abc","attr":"Hello from 8080"}
訪問 localhost:9090/demo/get → 返回 {"sessionId":"abc","attr":"Hello from 8080"} 同一 SessionId、數據共享
訪問 localhost:9090/demo/put → 更新屬性
再訪 localhost:8080/demo/get → 看到最新值 雙向同步

原理解析

@EnableRedisHttpSession 導入 SpringHttpSessionConfiguration，註冊 SessionRepositoryFilter；
Filter 攔截請求，用 RedisOperationsSessionRepository 讀寫 Redis Hash（Key: spring:session:sessions:{id}）；
Cookie SESSION 傳遞 SessionId，默認 30 分鐘滑動過期。

生產環境優化清單

常見問題排查

SessionId 每次請求都變：檢查 Cookie 域名/路徑/同站策略，確保瀏覽器正確攜帶；
Redis 連線超時：調大 spring.redis.timeout、啟用 Lettuce 連線池；
屬性值丟失：確認對象實現 Serializable 或配置 JSON 序列化器。

上一篇文章： Java 線程優雅停止：volatile 布爾標誌位模式深度解析
下一篇文章： Spring Boot 圖片上傳與靜態訪問實戰：自定義存儲路徑、ResourceHandler 配置全解析

Java 相關知識

FESI 腳本引擎：為 Java 應用注入動態腳本能力的實戰指南

Java 語言雖然功能強大、生態完善，但其編譯執行模型在快速

精通 Grails：企業級應用的監控與配置實戰

關於 Grails 是否適合企業環境，簡短回答是「是」。更精

NetBeans IDE 視覺化 Web JSF 快速入門：建立互動式 Web 應用

教學目標使用 NetBeans IDE 視覺化設計器，從零

深入淺出 Java 多線程（二）：Swing EDT 與單實例鎖的正確姿勢

問題背景：如何保證 Swing 程式單實例運行？ Java

Hibernate 批量更新與刪除的效能優化策略 Hibernate 延遲屬性加載原理與字節碼增強實踐 Java Web Servlet 基礎配置詳解：web.xml 映射規則與容器匹配邏輯基於 JXL 的 Excel 導出工具封裝：支持 JDBC 與內存數據雙模式 Java 日期時間處理大全：Date、Calendar 與 Object 核心方法詳解 JBuilder 實現 Visual Studio 風格巨集擴充功能完整指南 Spring 核心原理：IoC 與 DI 深度解析與程式碼實戰

欄目導航

優化點	配置/建議
序列化	改用 `GenericJackson2JsonRedisSerializer` 替代 JDK 序列化，體積小、可讀、跨語言
高可用	Redis Cluster / Sentinel + Lettuce `MasterSlaveTopologyRefresh`
Session 固定	關鍵業務（支付、下單）可綁定用戶 ID 作為 Session 附加屬性，防止會話劫持
監控	暴露 `spring.session.redis.*` 指標接入 Prometheus/Grafana
Nginx 親和性	若無法全共享，可用 `ip_hash` 降低跨實例概率（不推薦長期依賴）