对于最新的稳定版本,请使用 Spring Boot 3.5.5spring-doc.cadn.net.cn

计划任务 (scheduledtasks)

scheduledtasksendpoint 提供有关应用程序的计划任务的信息。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: 1222

{
  "cron" : [ {
    "runnable" : {
      "target" : "com.example.Processor.processOrders"
    },
    "expression" : "0 0 0/3 1/1 * ?",
    "nextExecution" : {
      "time" : "2025-08-21T08:59:59.999792328Z"
    }
  } ],
  "fixedDelay" : [ {
    "runnable" : {
      "target" : "com.example.Processor.purge"
    },
    "initialDelay" : 0,
    "interval" : 5000,
    "nextExecution" : {
      "time" : "2025-08-21T06:38:31.670362884Z"
    },
    "lastExecution" : {
      "time" : "2025-08-21T06:38:26.662161519Z",
      "status" : "SUCCESS"
    }
  } ],
  "fixedRate" : [ {
    "runnable" : {
      "target" : "com.example.Processor.retrieveIssues"
    },
    "initialDelay" : 10000,
    "interval" : 3000,
    "nextExecution" : {
      "time" : "2025-08-21T06:38:36.656833003Z"
    }
  } ],
  "custom" : [ {
    "runnable" : {
      "target" : "com.example.Processor$CustomTriggeredRunnable@65b2f815"
    },
    "trigger" : "com.example.Processor$CustomTrigger@1a8b2ab3",
    "lastExecution" : {
      "exception" : {
        "message" : "Failed while running custom task",
        "type" : "java.lang.IllegalStateException"
      },
      "time" : "2025-08-21T06:38:26.692340396Z",
      "status" : "ERROR"
    }
  } ]
}

响应结构

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

路径 类型 描述

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

上次执行的状态(STARTED、SUCCESS、ERROR)。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