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

Liquibase（`liquibase`）

liquibase 端点提供有关 Liquibase 所应用的数据库变更集的信息。spring-doc.cadn.net.cn

检索变更

要获取变更信息，请向 GET 发起一个 /actuator/liquibase 请求，如下列基于 curl 的示例所示：spring-doc.cadn.net.cn

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

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

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

{
  "contexts" : {
    "application" : {
      "liquibaseBeans" : {
        "liquibase" : {
          "changeSets" : [ {
            "author" : "marceloverdijk",
            "changeLog" : "org/springframework/boot/actuate/docs/liquibase/db.changelog-master.yaml",
            "checksum" : "9:d3589feb2baad02e15540750499ba311",
            "comments" : "",
            "contexts" : [ ],
            "dateExecuted" : "2026-03-20T00:33:01.216Z",
            "deploymentId" : "3966777849",
            "description" : "createTable tableName=customer",
            "execType" : "EXECUTED",
            "id" : "1",
            "labels" : [ ],
            "orderExecuted" : 1
          } ]
        }
      }
    }
  }
}

响应结构

响应包含应用程序的 Liquibase 变更集的详细信息。下表描述了响应的结构：spring-doc.cadn.net.cn

路径类型 <description> </description>

路径	类型	<description> </description>
`contexts`spring-doc.cadn.net.cn	`Object`spring-doc.cadn.net.cn	按 ID 键控的应用程序上下文spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets`spring-doc.cadn.net.cn	`Array`spring-doc.cadn.net.cn	由 Liquibase Bean 所执行的变更集，以 Bean 名称为键。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].author`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的作者。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].changeLog`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	包含变更集的变更日志。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].comments`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的注释。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].contexts`spring-doc.cadn.net.cn	`Array`spring-doc.cadn.net.cn	变更集的上下文。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].dateExecuted`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集执行时的时间戳。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].deploymentId`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	执行该变更集的部署的ID。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].description`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的描述。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].execType`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的执行类型（`EXECUTED`、`FAILED`、`SKIPPED`、`RERAN`、`MARK_RAN`）。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].id`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的 ID。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].labels`spring-doc.cadn.net.cn	`Array`spring-doc.cadn.net.cn	与变更集关联的标签。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].checksum`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	变更集的校验和。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].orderExecuted`spring-doc.cadn.net.cn	`Number`spring-doc.cadn.net.cn	变更集的执行顺序。spring-doc.cadn.net.cn
`contexts..liquibaseBeans..changeSets[].tag`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	与变更集关联的标签（如果有的话）。spring-doc.cadn.net.cn
`contexts.*.parentId`spring-doc.cadn.net.cn	`String`spring-doc.cadn.net.cn	父应用上下文的 ID（如果有的话）。spring-doc.cadn.net.cn

contextsspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按 ID 键控的应用程序上下文spring-doc.cadn.net.cn

contexts.*.liquibaseBeans.*.changeSetsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

由 Liquibase Bean 所执行的变更集，以 Bean 名称为键。spring-doc.cadn.net.cn

contexts.*.liquibaseBeans.*.changeSets[].authorspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

变更集的作者。spring-doc.cadn.net.cn

contexts.*.liquibaseBeans.*.changeSets[].changeLogspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

包含变更集的变更日志。spring-doc.cadn.net.cn