4. 依赖关系声明方式：在 XML 中声明 dependsOn、在 YAML 中声明、在 JSON 中声明、在 SQL 中声明

Liquibase 支持四种变更集描述格式：XML、YAML、JSON 和 SQL。每种格式都提供了声明依赖关系（dependsOn）的语法。理解这些声明方式，是进行冒烟验证和故障排查的基础——错误的格式或遗漏的依赖声明，是导致变更集执行顺序混乱的常见根源。

4.1 在 XML 中声明 dependsOn

XML 是 Liquibase 最传统、最成熟的格式。依赖关系通过 <preConditions> 内部的 <changesetExecuted> 元素，或直接在 <changeset> 上使用 dependsOn 属性来声明。推荐使用 dependsOn 属性，因为它更直观、更简洁。

<?xml version="1.0" encoding="UTF-8"?>
<databaseChangeLog
    xmlns="http://www.liquibase.org/xml/ns/dbchangelog"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.liquibase.org/xml/ns/dbchangelog
                        http://www.liquibase.org/xml/ns/dbchangelog/dbchangelog-4.20.xsd">

    <changeSet id="1" author="alice">
        <createTable tableName="users">
            <column name="id" type="int">
                <constraints primaryKey="true"/>
            </column>
            <column name="name" type="varchar(255)"/>
        </createTable>
    </changeSet>

    <changeSet id="2" author="bob" dependsOn="1">
        <comment>依赖 changeset id=1, author=alice</comment>
        <addColumn tableName="users">
            <column name="email" type="varchar(255)"/>
        </addColumn>
    </changeSet>

    <!-- 多依赖：使用逗号分隔 -->
    <changeSet id="3" author="carol" dependsOn="1, 2">
        <createIndex indexName="idx_users_email" tableName="users">
            <column name="email"/>
        </createIndex>
    </changeSet>

</databaseChangeLog>

4.2 在 YAML 中声明 dependsOn

YAML 格式以其简洁和可读性受到许多团队的青睐。依赖关系通过 dependsOn 键来声明，其值可以是一个字符串（单个依赖）或一个列表（多个依赖）。

databaseChangeLog:
  - changeSet:
      id: 1
      author: alice
      changes:
        - createTable:
            tableName: orders
            columns:
              - column:
                  name: id
                  type: int
                  constraints:
                    primaryKey: true
              - column:
                  name: product
                  type: varchar(255)

  - changeSet:
      id: 2
      author: bob
      dependsOn: "1"  # 单依赖，字符串形式
      changes:
        - addColumn:
            tableName: orders
            columns:
              - column:
                  name: quantity
                  type: int

  - changeSet:
      id: 3
      author: carol
      dependsOn:      # 多依赖，列表形式
        - "1"
        - "2"
      changes:
        - createIndex:
            indexName: idx_orders_product
            tableName: orders
            columns:
              - column:
                  name: product

4.3 在 JSON 中声明 dependsOn

JSON 格式在自动化生成和工具集成场景中很常见。依赖关系通过 "dependsOn" 键来声明，其值可以是字符串或数组。

{
  "databaseChangeLog": [
    {
      "changeSet": {
        "id": "1",
        "author": "alice",
        "changes": [
          {
            "createTable": {
              "tableName": "products",
              "columns": [
                { "column": { "name": "id", "type": "int", "constraints": { "primaryKey": true } } },
                { "column": { "name": "name", "type": "varchar(255)" } }
              ]
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "2",
        "author": "bob",
        "dependsOn": "1",
        "changes": [
          {
            "addColumn": {
              "tableName": "products",
              "columns": [
                { "column": { "name": "price", "type": "decimal(10,2)" } }
              ]
            }
          }
        ]
      }
    },
    {
      "changeSet": {
        "id": "3",
        "author": "carol",
        "dependsOn": ["1", "2"],
        "changes": [
          {
            "createIndex": {
              "indexName": "idx_products_name",
              "tableName": "products",
              "columns": [
                { "column": { "name": "name" } }
              ]
            }
          }
        ]
      }
    }
  ]
}

4.4 在 SQL 中声明 dependsOn

SQL 格式与其他三种格式有本质区别：它没有结构化的 dependsOn 属性。依赖关系通过 SQL 注释中的 Liquibase 指令来声明，或者通过 preconditions 注释块来实现。

-- liquibase formatted sql

-- changeset alice:1
CREATE TABLE customers (
    id INT PRIMARY KEY,
    name VARCHAR(255)
);
-- rollback DROP TABLE customers;

-- changeset bob:2 dependsOn:1
-- 依赖 changeset alice:1
ALTER TABLE customers ADD COLUMN phone VARCHAR(20);
-- rollback ALTER TABLE customers DROP COLUMN phone;

-- changeset carol:3 dependsOn:1,2
-- 多依赖：依赖 alice:1 和 bob:2
CREATE INDEX idx_customers_name ON customers(name);
-- rollback DROP INDEX idx_customers_name;

4.5 四种声明方式对比

4.6 依赖声明方式的结构对比

下面的 SVG 图展示了四种格式在声明依赖时的结构差异，帮助你在冒烟验证时快速定位声明位置。

4.7 故障排查：依赖声明常见错误

在冒烟验证阶段，以下错误是导致依赖关系失效的高频原因。建议在验证脚本中逐一检查。