|
此版本仍在开发中,尚未视为稳定版。如需最新稳定版本,请使用 Spring Boot 4.0.4! |
定时任务(scheduledtasks)
scheduledtasks 端点提供有关应用程序的定时任务的信息。
检索计划任务
要获取已调度的任务,请向 GET 发起一个 /actuator/scheduledtasks 请求,如下列基于 curl 的示例所示:
$ curl 'http://localhost:8080/actuator/scheduledtasks' -i -X GET
生成的响应类似于以下内容:
HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 1221
{
"cron" : [ {
"expression" : "0 0 0/3 1/1 * ?",
"nextExecution" : {
"time" : "2026-03-19T23:59:59.999675761Z"
},
"runnable" : {
"target" : "com.example.Processor.processOrders"
}
} ],
"custom" : [ {
"lastExecution" : {
"exception" : {
"message" : "Failed while running custom task",
"type" : "java.lang.IllegalStateException"
},
"status" : "ERROR",
"time" : "2026-03-19T22:23:57.251129217Z"
},
"runnable" : {
"target" : "com.example.Processor$CustomTriggeredRunnable@5379bea3"
},
"trigger" : "com.example.Processor$CustomTrigger@7ffa2be"
} ],
"fixedDelay" : [ {
"initialDelay" : 0,
"interval" : 5000,
"lastExecution" : {
"status" : "SUCCESS",
"time" : "2026-03-19T22:23:57.222002241Z"
},
"nextExecution" : {
"time" : "2026-03-19T22:24:02.231934217Z"
},
"runnable" : {
"target" : "com.example.Processor.purge"
}
} ],
"fixedRate" : [ {
"initialDelay" : 10000,
"interval" : 3000,
"nextExecution" : {
"time" : "2026-03-19T22:24:07.221517279Z"
},
"runnable" : {
"target" : "com.example.Processor.retrieveIssues"
}
} ]
}
响应结构
响应包含应用程序计划任务的详细信息。 下表描述了响应的结构:
| 路径 | 类型 | <description> </description> |
|---|---|---|
|
|
Cron 任务(如果有)。 |
|
|
将要执行的目标。 |
|
|
下一次计划执行的时间。 |
|
|
Cron 表达式。 |
|
|
固定延迟任务(如果有)。 |
|
|
将要执行的目标。 |
|
|
首次执行前的延迟时间(以毫秒为单位)。 |
|
|
下次计划执行的时间(如果已知)。 |
|
|
上一次执行结束与下一次执行开始之间的间隔时间(以毫秒为单位)。 |
|
|
固定频率的任务(如果有)。 |
|
|
将要执行的目标。 |
|
|
每次执行开始之间的时间间隔(以毫秒为单位)。 |
|
|
首次执行前的延迟时间(以毫秒为单位)。 |
|
|
下次计划执行的时间(如果已知)。 |
|
|
具有自定义触发器的任务(如果有)。 |
|
|
将要执行的目标。 |
|
|
任务的触发器。 |
|
|
此任务的上次执行时间(如果有的话)。 |
|
|
上次执行的状态(已开始、成功、错误)。 |
|
|
上次执行的时间。 |
|
|
任务抛出的异常类型(如果有)。 |
|
|
任务抛出的异常消息(如果有的话)。 |