贝利信息

NEWS CENTER 新闻中心

使用Flyway或Liquibase进行MySQL数据库版本控制与迁移

日期：2025-09-09 00:00 / 作者：夜晨
上一篇 下一篇
数据库版本控制工具Flyway和Liquibase通过将Schema变更代码化，实现自动化、可追溯的迁移管理。Flyway以简洁和SQL优先著称，适合小型项目和SQL熟练团队；Liquibase提供多格式支持与回滚能力，适用于复杂企业级或多数据库环境。两者均需集成至构建工具（如Maven/Gradle），并通过配置连接信息执行迁移。关键实践包括避免硬编码凭据、处理并发冲突、谨慎管理回滚及始终备份生产数据，确保迁移安全可靠。

数据库版本控制与迁移，无论是使用Flyway还是Liquibase，其核心目的都是为了让数据库Schema的变更变得可追溯、自动化且可重复。这极大地减少了手动变更可能引入的错误，确保了开发、测试和生产环境之间数据库结构的一致性，从而让部署过程更加顺畅和安全。

解决方案

在现代软件开发中，数据库Schema的演进是不可避免的。从最初的表结构设计到后续的功能迭代，数据库往往需要进行字段增删改、索引调整、存储过程更新等操作。手动执行这些变更不仅效率低下，而且极易出错，尤其是在团队协作和多环境部署的场景下，手动操作几乎是灾难的温径。

Flyway和Liquibase正是为解决这些痛点而生的。它们通过将数据库Schema的变更视为代码，纳入版本控制系统，从而实现：

  1. 自动化执行： 脚本化的变更可以被工具自动识别并按顺序执行。
  2. 版本追踪： 每次变更都有唯一的版本号，工具会记录已执行的版本，避免重复执行。
  3. 环境一致性： 确保所有环境（开发、测试、生产）的数据库Schema都处于预期的状态。
  4. 可回溯性： 理论上，我们可以知道任何一个时间点数据库的Schema状态。

Flyway 的设计哲学是“约定优于配置”，它推崇使用纯SQL脚本进行迁移，并严格按照文件名的版本号顺序执行。它的操作相对简单直观，对于习惯直接编写SQL的团队来说，学习成本非常低。Flyway会维护一个

flyway_schema_history
表（默认名称），记录所有已执行的迁移脚本及其状态。

Liquibase 则提供了更强大的抽象层和灵活性。它支持多种变更日志格式，包括SQL、XML、YAML和JSON。Liquibase的“变更集”（Changeset）概念允许更细粒度的控制，并且它提供了更丰富的命令，例如生成Schema差异、回滚等。Liquibase通过

databasechangelog
和
databasechangeloglock
两张表来管理迁移历史和并发控制。

无论选择哪一个，其基本工作流程都是：

  1. 初始化项目： 在你的项目（如Maven或Gradle）中引入Flyway或Liquibase的依赖。
  2. 配置数据库连接： 提供MySQL数据库的连接信息（URL、用户名、密码）。
  3. 创建迁移脚本： 编写SQL文件（Flyway）或变更日志文件（Liquibase），定义数据库的变更。
    • Flyway的SQL脚本通常以
      V<版本号>__<描述>.sql
      命名，例如
      V1.0.0__create_user_table.sql
      。
    • Liquibase的变更集则包含在主变更日志文件中，每个变更集有唯一的ID和作者。
  4. 执行迁移： 通过命令行、构建工具插件或在应用程序启动时，调用工具执行迁移命令。工具会检查数据库的当前版本，并执行所有尚未执行的脚本。

通过这种方式，数据库的Schema变更就如同代码提交一样，变得可管理、可协作，也更安全。

Flyway和Liquibase在MySQL数据库版本控制中各有哪些优势和适用场景？

选择Flyway还是Liquibase，很大程度上取决于团队的技术栈、项目规模以及对数据库变更控制的精细程度要求。我发现很多时候，大家在做这个选择时，会陷入一些技术细节的纠结，但实际上，更重要的是理解它们背后的设计理念和它们各自的适用场景。

Flyway的优势与适用场景：

Liquibase的优势与适用场景：

我个人在一些小型微服务项目中，更偏爱Flyway的直接和简洁，它让我感觉对数据库的掌控力更强。但在我参与过的一些大型企业项目中，Liquibase的灵活性和回滚能力确实提供了更强的安全感和管理能力。所以，没有绝对的好坏，只有是否适合你的项目和团队。

如何在Maven或Gradle项目中集成Flyway/Liquibase进行MySQL数据库迁移？

将数据库版本控制工具集成到构建工具中，是实现自动化迁移的关键一步。这通常意味着在你的CI/CD流程中，数据库迁移可以作为一个标准的步骤被执行。我发现很多初学者在这一步容易犯错，比如配置路径不正确、数据库连接信息泄露等。

Maven集成示例：

以Flyway为例，你需要在项目的

pom.xml
文件中添加Flyway Maven插件。


    
        
            org.flywaydb
            flyway-maven-plugin
            9.22.3 
            
                
                jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC
                your_user
                your_password
                
                
                    filesystem:src/main/resources/db/migration
                
                
                
            
            
                
                    flyway-migrate
                    
                        migrate
                    
                    
                    process-resources
                
            
            
                
                
                    mysql
                    mysql-connector-java
                    8.0.33

然后，你的SQL迁移脚本应该存放在

src/main/resources/db/migration
目录下，例如：

src/main/resources/db/migration/V1__initial_schema.sql

CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    username VARCHAR(50) NOT NULL UNIQUE,
    email VARCHAR(100) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

执行

mvn clean install
或
mvn flyway:migrate
命令时，Flyway就会自动检查并执行尚未应用的迁移脚本。

Gradle集成示例：

以Liquibase为例，你需要在项目的

build.gradle
文件中添加Liquibase Gradle插件。

plugins {
    id 'java'
    id 'org.liquibase.gradle' version '2.2.0' // 请使用最新的稳定版本
}

repositories {
    mavenCentral()
}

dependencies {
    // MySQL JDBC Driver
    liquibaseRuntime 'mysql:mysql-connector-java:8.0.33' // 确保版本与你的MySQL服务器兼容
    // Liquibase Core
    implementation 'org.liquibase:liquibase-core:4.23.0' // 请使用最新的稳定版本
}

liquibase {
    activities {
        main {
            // 主变更日志文件路径
            changeLogFile 'src/main/resources/db/changelog/db.changelog-master.yaml'
            // MySQL数据库连接信息
            url 'jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC'
            username 'your_user'
            password 'your_password'
            driver 'com.mysql.cj.jdbc.Driver'
        }
    }
}

你的主变更日志文件（例如

db.changelog-master.yaml
）应该存放在
src/main/resources/db/changelog
目录下，并引用具体的变更集文件：

src/main/resources/db/changelog/db.changelog-master.yaml

databaseChangeLog:
  - include:
      file: db/changelog/changes/001-create-user-table.yaml
      relativeToChangelogFile: true

src/main/resources/db/changelog/changes/001-create-user-table.yaml

databaseChangeLog:
  - changeSet:
      id: 1
      author: your_name
      changes:
        - createTable:
            tableName: users
            columns:
              - column:
                  name: id
                  type: INT
                  autoIncrement: true
                  constraints:
                    primaryKey: true
                    nullable: false
              - column:
                  name: username
                  type: VARCHAR(50)
                  constraints:
                    nullable: false
                    unique: true
              - column:
                  name: email
                  type: VARCHAR(100)
                  constraints:
                    nullable: false
              - column:
                  name: created_at
                  type: TIMESTAMP
                  defaultValueComputed: CURRENT_TIMESTAMP

执行

gradle update
命令时，Liquibase会读取变更日志并执行相应的数据库迁移。

关于数据库连接信息的安全： 在实际项目中，绝不能将敏感的数据库用户名和密码直接硬编码在

pom.xml
或
build.gradle
中。我通常会使用Maven的
settings.xml
文件中的
配置、环境变量，或者在Spring Boot应用中通过
application.properties
/
application.yml
来管理这些信息，并利用构建工具的profile或外部化配置来适配不同环境。这是非常关键的一点，否则你的凭据就会随着代码一起泄露。

使用数据库版本控制工具时，如何处理常见的挑战和错误，并确保数据安全？

即使有了强大的数据库版本控制工具，我们在实际操作中仍然会遇到各种挑战，甚至犯下一些代价高昂的错误。我个人在处理数据库迁移时，总是抱着一种如履薄冰的心态，因为任何一个微小的失误都可能导致生产环境的崩溃或数据丢失。

1. 常见的挑战：

2. 确保数据安全：