Sessions (sessions)

QWen Max 中英对照 Sessions (sessions) Sessions (sessions)

sessions 端点提供由 Spring Session 管理的应用程序 HTTP 会话的相关信息。

获取会话

要检索会话，请向 /actuator/sessions 发起 GET 请求，如下列基于 curl 的示例所示：

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

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

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

{
  "sessions" : [ {
    "attributeNames" : [ ],
    "creationTime" : "2026-01-22T00:43:52.704389937Z",
    "expired" : false,
    "id" : "4d1c7ff1-473f-4ba1-bb51-458ee68d5642",
    "lastAccessedTime" : "2026-01-22T12:43:07.704397250Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-01-22T07:43:52.710111964Z",
    "expired" : false,
    "id" : "4db5efcc-99cb-4d05-a52c-b49acfbb7ea9",
    "lastAccessedTime" : "2026-01-22T12:43:15.710115300Z",
    "maxInactiveInterval" : 1800
  }, {
    "attributeNames" : [ ],
    "creationTime" : "2026-01-22T10:43:52.710118035Z",
    "expired" : false,
    "id" : "e00f2b82-dc2d-4dd2-b5b5-a6f8e3cad632",
    "lastAccessedTime" : "2026-01-22T12:43:40.710118486Z",
    "maxInactiveInterval" : 1800
  } ]
}

查询参数

该端点使用查询参数来限制返回的会话。下表显示了唯一必需的查询参数：

Parameter	Description
username	用户的名称。

响应结构

响应包含匹配会话的详细信息。下表描述了响应的结构：

路径	类型	描述
sessions	Array	给定用户名的会话。
sessions.[].id	String	会话的 ID。
sessions.[].attributeNames	Array	存储在会话中的属性名称。
sessions.[].creationTime	String	会话创建的时间戳。
sessions.[].lastAccessedTime	String	会话最后一次被访问的时间戳。
sessions.[].maxInactiveInterval	Number	会话过期前允许的最大不活动时间（以秒为单位）。
sessions.[].expired	Boolean	会话是否已过期。

获取单个会话

要检索单个会话，请向 /actuator/sessions/{id} 发起 GET 请求，如下列基于 curl 的示例所示：

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

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

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

{"attributeNames":[],"creationTime":"2026-01-22T07:43:52.710111964Z","expired":false,"id":"4db5efcc-99cb-4d05-a52c-b49acfbb7ea9","lastAccessedTime":"2026-01-22T12:43:15.710115300Z","maxInactiveInterval":1800}

响应结构

响应包含所请求会话的详细信息。下表描述了响应的结构：

Path	Type	Description
id	String	会话的 ID。
attributeNames	Array	存储在会话中的属性名称。
creationTime	String	会话创建的时间戳。
lastAccessedTime	String	会话最后一次被访问的时间戳。
maxInactiveInterval	Number	会话过期前允许的最大不活动时间（以秒为单位）。
expired	Boolean	会话是否已过期。

删除会话

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

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

前面的示例删除了 id 为 4db5efcc-99cb-4d05-a52c-b49acfbb7ea9 的会话。