Spring Session

Spring Boot 为各种数据存储提供了 Spring Session 自动配置。构建 Servlet Web 应用时,可以自动配置以下数据存储:

  • Redis

  • JDBC

  • Hazelcast

  • MongoDB

Servlet 自动配置取代了使用 @Enable*HttpSession 的需求。

如果类路径上存在单个 Spring Session 模块,Spring Boot 会自动使用该存储实现。如果存在多个实现,Spring Boot 会按以下顺序选择特定的实现:

  1. Redis

  2. JDBC

  3. Hazelcast

  4. MongoDB

  5. 如果 Redis、JDBC、Hazelcast 和 MongoDB 均不可用,我们将不配置 SessionRepository

构建响应式 Web 应用时,可以自动配置以下数据存储:

  • Redis

  • MongoDB

响应式自动配置取代了使用 @Enable*WebSession 的需求。

与 Servlet 配置类似,如果存在多个实现,Spring Boot 会按以下顺序选择特定的实现:

  1. Redis

  2. MongoDB

  3. 如果 Redis 和 MongoDB 均不可用,我们将不配置 ReactiveSessionRepository

每种存储都有特定的附加设置。例如,可以自定义 JDBC 存储的表名,如下例所示:

  • Properties

  • YAML

spring.session.jdbc.table-name=SESSIONS
spring:
  session:
    jdbc:
      table-name: "SESSIONS"

你可以使用 spring.session.timeout 属性来设置 Session 的超时时间。如果 Servlet Web 应用中未设置该属性,自动配置将回退到 server.servlet.session.timeout 的值。

你可以使用 @Enable*HttpSession (Servlet) 或 @Enable*WebSession (响应式) 来控制 Spring Session 的配置。这会导致自动配置失效。然后可以使用注解的属性而不是前面描述的配置属性来配置 Spring Session。