4. Liquibase 支持的数据库

Liquibase 通过 JDBC 驱动与多种主流关系型数据库集成。本章列出官方支持的数据库清单、对应的 Maven/Gradle 驱动坐标以及标准的 JDBC 连接串格式，帮助你在环境配置阶段快速完成驱动引入与连接验证。

4.1 支持的数据库总览

Liquibase 官方测试矩阵覆盖以下数据库。生产环境建议优先选择“完全支持”的数据库，社区扩展数据库需额外验证。

4.2 各数据库驱动配置

以下给出 Maven 和 Gradle 两种构建工具的依赖声明。如果你使用 Liquibase Maven 插件或 Gradle 插件，驱动依赖会自动加入类路径。

4.2.1 Maven 依赖示例

<!-- Oracle -->
<dependency>
    <groupId>com.oracle.database.jdbc</groupId>
    <artifactId>ojdbc8</artifactId>
    <version>19.21.0.0</version>
</dependency>

<!-- MySQL -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.0.33</version>
</dependency>

<!-- PostgreSQL -->
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.6.0</version>
</dependency>

<!-- Microsoft SQL Server -->
<dependency>
    <groupId>com.microsoft.sqlserver</groupId>
    <artifactId>mssql-jdbc</artifactId>
    <version>12.4.2.jre11</version>
</dependency>

<!-- H2 (内存数据库，常用于测试) -->
<dependency>
    <groupId>com.h2database</groupId>
    <artifactId>h2</artifactId>
    <version>2.2.224</version>
    <scope>test</scope>
</dependency>

4.2.2 Gradle 依赖示例

// Oracle
implementation 'com.oracle.database.jdbc:ojdbc8:19.21.0.0'

// MySQL
implementation 'com.mysql:mysql-connector-j:8.0.33'

// PostgreSQL
implementation 'org.postgresql:postgresql:42.6.0'

// SQL Server
implementation 'com.microsoft.sqlserver:mssql-jdbc:12.4.2.jre11'

// H2 (test scope)
testImplementation 'com.h2database:h2:2.2.224'

4.3 JDBC 连接串格式

JDBC URL 是 Liquibase 连接数据库的核心参数，格式错误会导致连接失败。以下列出各数据库的标准连接串模板及关键参数说明。

4.4 驱动与连接串的匹配关系图

下图展示从 Liquibase 配置到数据库实例的完整驱动加载与连接建立流程，帮助你理解各组件之间的依赖关系。

4.5 冒烟检查：快速验证数据库连接

在编写第一个变更集之前，建议执行一次冒烟检查，确认 Liquibase 能够成功加载驱动并建立连接。以下是一个最小化的 liquibase.properties 配置示例：

# liquibase.properties 冒烟检查配置
changeLogFile: db/changelog/db.changelog-master.xml
driver: org.postgresql.Driver
url: jdbc:postgresql://localhost:5432/liquibase_demo?currentSchema=public
username: liquibase_user
password: liquibase_pass
liquibaseSchemaName: liquibase_schema
liquibaseTablespaceName: liquibase_tbs

执行以下命令验证连接：

# 使用 Liquibase CLI 执行 status 命令，不实际写入数据库
liquibase --defaultsFile=liquibase.properties status

# 预期输出示例：
# - Database: jdbc:postgresql://localhost:5432/liquibase_demo
# - Driver: PostgreSQL JDBC Driver 42.6.0
# - 1 change set has not been applied to postgresql@localhost

4.6 常见连接问题与排查