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

定时任务(scheduledtasks

scheduledtasks 端点提供有关应用程序的定时任务的信息。spring-doc.cadn.net.cn

检索计划任务

要获取已调度的任务,请向 GET 发起一个 /actuator/scheduledtasks 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/scheduledtasks' -i -X GET

生成的响应类似于以下内容:spring-doc.cadn.net.cn

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-20T02:59:59.999704634Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.processOrders"
    }
  } ],
  "custom" : [ {
    "lastExecution" : {
      "exception" : {
        "message" : "Failed while running custom task",
        "type" : "java.lang.IllegalStateException"
      },
      "status" : "ERROR",
      "time" : "2026-03-20T00:33:08.442493999Z"
    },
    "runnable" : {
      "target" : "com.example.Processor$CustomTriggeredRunnable@4ded3a8"
    },
    "trigger" : "com.example.Processor$CustomTrigger@7e4e6bdf"
  } ],
  "fixedDelay" : [ {
    "initialDelay" : 0,
    "interval" : 5000,
    "lastExecution" : {
      "status" : "SUCCESS",
      "time" : "2026-03-20T00:33:08.408246920Z"
    },
    "nextExecution" : {
      "time" : "2026-03-20T00:33:13.416965172Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.purge"
    }
  } ],
  "fixedRate" : [ {
    "initialDelay" : 10000,
    "interval" : 3000,
    "nextExecution" : {
      "time" : "2026-03-20T00:33:18.403192062Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.retrieveIssues"
    }
  } ]
}

响应结构

响应包含应用程序计划任务的详细信息。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

cronspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

Cron 任务(如果有)。spring-doc.cadn.net.cn

cron.[].runnable.targetspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

将要执行的目标。spring-doc.cadn.net.cn

cron.[].nextExecution.timespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

下一次计划执行的时间。spring-doc.cadn.net.cn

cron.[].expressionspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

Cron 表达式。spring-doc.cadn.net.cn

fixedDelayspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

固定延迟任务(如果有)。spring-doc.cadn.net.cn

fixedDelay.[].runnable.targetspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

将要执行的目标。spring-doc.cadn.net.cn

fixedDelay.[].initialDelayspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

首次执行前的延迟时间(以毫秒为单位)。spring-doc.cadn.net.cn

fixedDelay.[].nextExecution.timespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

下次计划执行的时间(如果已知)。spring-doc.cadn.net.cn

fixedDelay.[].intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

上一次执行结束与下一次执行开始之间的间隔时间(以毫秒为单位)。spring-doc.cadn.net.cn

fixedRatespring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

固定频率的任务(如果有)。spring-doc.cadn.net.cn

fixedRate.[].runnable.targetspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

将要执行的目标。spring-doc.cadn.net.cn

fixedRate.[].intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

每次执行开始之间的时间间隔(以毫秒为单位)。spring-doc.cadn.net.cn

fixedRate.[].initialDelayspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

首次执行前的延迟时间(以毫秒为单位)。spring-doc.cadn.net.cn

fixedRate.[].nextExecution.timespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

下次计划执行的时间(如果已知)。spring-doc.cadn.net.cn

customspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

具有自定义触发器的任务(如果有)。spring-doc.cadn.net.cn

custom.[].runnable.targetspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

将要执行的目标。spring-doc.cadn.net.cn

custom.[].triggerspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

任务的触发器。spring-doc.cadn.net.cn

*.[].lastExecutionspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

此任务的上次执行时间(如果有的话)。spring-doc.cadn.net.cn

*.[].lastExecution.statusspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

上次执行的状态(已开始、成功、错误)。spring-doc.cadn.net.cn

*.[].lastExecution.timespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

上次执行的时间。spring-doc.cadn.net.cn

*.[].lastExecution.exception.typespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

任务抛出的异常类型(如果有)。spring-doc.cadn.net.cn

*.[].lastExecution.exception.messagespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

任务抛出的异常消息(如果有的话)。spring-doc.cadn.net.cn