定时任务 (scheduledtasks)

QWen Max 中英对照 Scheduled Tasks (scheduledtasks) Scheduled Tasks (scheduledtasks)

scheduledtasks 端点提供有关应用程序的计划任务的信息。

获取计划任务

要获取计划任务，请向 /actuator/scheduledtasks 发起 GET 请求，如下列基于 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-01-22T14:59:59.999293154Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.processOrders"
    }
  } ],
  "custom" : [ {
    "lastExecution" : {
      "exception" : {
        "message" : "Failed while running custom task",
        "type" : "java.lang.IllegalStateException"
      },
      "status" : "ERROR",
      "time" : "2026-01-22T12:43:52.650111196Z"
    },
    "runnable" : {
      "target" : "com.example.Processor$CustomTriggeredRunnable@1e8b6b92"
    },
    "trigger" : "com.example.Processor$CustomTrigger@b67503a"
  } ],
  "fixedDelay" : [ {
    "initialDelay" : 0,
    "interval" : 5000,
    "lastExecution" : {
      "status" : "SUCCESS",
      "time" : "2026-01-22T12:43:52.579215451Z"
    },
    "nextExecution" : {
      "time" : "2026-01-22T12:43:57.594029040Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.purge"
    }
  } ],
  "fixedRate" : [ {
    "initialDelay" : 10000,
    "interval" : 3000,
    "nextExecution" : {
      "time" : "2026-01-22T12:44:02.571548436Z"
    },
    "runnable" : {
      "target" : "com.example.Processor.retrieveIssues"
    }
  } ]
}

响应结构

响应包含应用程序计划任务的详细信息。下表描述了响应的结构：

路径	类型	描述
cron	Array	Cron 任务（如果有）。
cron.[].runnable.target	String	将要执行的目标。
cron.[].nextExecution.time	String	下一次计划执行的时间。
cron.[].expression	String	Cron 表达式。
fixedDelay	Array	固定延迟任务（如果有）。
fixedDelay.[].runnable.target	String	将要执行的目标。
fixedDelay.[].initialDelay	Number	首次执行前的延迟时间（毫秒）。
fixedDelay.[].nextExecution.time	String	下一次计划执行的时间（如果已知）。
fixedDelay.[].interval	Number	上次执行结束与下次执行开始之间的间隔（毫秒）。
fixedRate	Array	固定速率任务（如果有）。
fixedRate.[].runnable.target	String	将要执行的目标。
fixedRate.[].interval	Number	每次执行开始之间的间隔（毫秒）。
fixedRate.[].initialDelay	Number	首次执行前的延迟时间（毫秒）。
fixedRate.[].nextExecution.time	String	下一次计划执行的时间（如果已知）。
custom	Array	使用自定义触发器的任务（如果有）。
custom.[].runnable.target	String	将要执行的目标。
custom.[].trigger	String	任务的触发器。
*.[].lastExecution	Object	此任务的上一次执行（如果有）。
*.[].lastExecution.status	String	上一次执行的状态（STARTED, SUCCESS, ERROR）。
*.[].lastExecution.time	String	上一次执行的时间。
*.[].lastExecution.exception.type	String	任务抛出的异常类型（如果有）。
*.[].lastExecution.exception.message	String	任务抛出的异常消息（如果有）。