此版本仍在开发中，尚未视为稳定版。如需最新稳定版本，请使用 Spring Boot 4.0.4！spring-doc.cadn.net.cn

会话（sessions）

sessions 端点提供有关由 Spring Session 管理的应用程序 HTTP 会话的信息。spring-doc.cadn.net.cn

检索会话

要获取会话信息，请向 GET 发起一个 /actuator/sessions 请求，如下列基于 curl 的示例所示：spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/sessions?username=alice' -i -X GET

前面的示例检索用户名为 alice 的用户的所有会话。 返回的响应类似于以下内容：spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 789

{
  "sessions" : [ {
    "attributeNames" : [ ],
    "creationTime" : "2026-03-19T17:23:57.300218842Z",
    "expired" : false,
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "lastAccessedTime" : "2026-03-19T22:23:20.300221668Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-03-19T10:23:57.297404275Z",
    "expired" : false,
    "id" : "435357e5-394d-4cd3-a469-9a06f221ea3e",
    "lastAccessedTime" : "2026-03-19T22:23:12.297409364Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-03-19T20:23:57.300224954Z",
    "expired" : false,
    "id" : "9dfaed50-3cae-4cd5-b775-95defddee04c",
    "lastAccessedTime" : "2026-03-19T22:23:45.300225455Z",
    "maxInactiveInterval" : 1800
  } ]
}

查询参数

该端点使用查询参数来限制其返回的会话。 下表列出了唯一必需的查询参数：spring-doc.cadn.net.cn

参数 <description> </description>

usernamespring-doc.cadn.net.cn

用户名称。spring-doc.cadn.net.cn

响应结构

响应包含匹配会话的详细信息。 下表描述了响应的结构：spring-doc.cadn.net.cn

路径 类型 <description> </description>

sessionsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

指定用户名的会话。spring-doc.cadn.net.cn

sessions.[].idspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话的ID。spring-doc.cadn.net.cn

sessions.[].attributeNamesspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

存储在会话中的属性名称。spring-doc.cadn.net.cn

sessions.[].creationTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话创建的时间戳。spring-doc.cadn.net.cn

sessions.[].lastAccessedTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话最后一次被访问的时间戳。spring-doc.cadn.net.cn

sessions.[].maxInactiveIntervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

会话在过期前允许的最长非活动时间（以秒为单位）。spring-doc.cadn.net.cn

sessions.[].expiredspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

会话是否已过期。spring-doc.cadn.net.cn

检索单个会话

要获取单个会话，请向 GET 发起一个 /actuator/sessions/{id} 请求，如下列基于 curl 的示例所示：spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X GET

前面的示例检索了 id 为 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9 的会话。 返回的响应类似于以下内容：spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 208

{"attributeNames":[],"creationTime":"2026-03-19T17:23:57.300218842Z","expired":false,"id":"4db5efcc-99cb-4d05-a52c-b49acfbb7ea9","lastAccessedTime":"2026-03-19T22:23:20.300221668Z","maxInactiveInterval":1800}

响应结构

响应包含所请求会话的详细信息。 下表描述了响应的结构：spring-doc.cadn.net.cn

路径 类型 <description> </description>

idspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话的ID。spring-doc.cadn.net.cn

attributeNamesspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

存储在会话中的属性名称。spring-doc.cadn.net.cn

creationTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话创建的时间戳。spring-doc.cadn.net.cn

lastAccessedTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

会话最后一次被访问的时间戳。spring-doc.cadn.net.cn

maxInactiveIntervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

会话在过期前允许的最长非活动时间（以秒为单位）。spring-doc.cadn.net.cn

expiredspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

会话是否已过期。spring-doc.cadn.net.cn

删除会话

要删除一个会话，请向 DELETE 发送一个 /actuator/sessions/{id} 请求，如下列基于 curl 的示例所示：spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/sessions/4db5efcc-99cb-4d05-a52c-b49acfbb7ea9' -i -X DELETE

前面的示例删除了 id 为 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9 的会话。spring-doc.cadn.net.cn