告别手动改库表！MyBatis-Plus与Flyway/Liquibase无缝集成方案-优快云博客

告别手动改库表！MyBatis-Plus与Flyway/Liquibase无缝集成方案

【免费下载链接】mybatis-plus An powerful enhanced toolkit of MyBatis for simplify development 项目地址: https://gitcode.com/gh_mirrors/my/mybatis-plus

你是否还在为数据库版本混乱而头疼？团队协作时因SQL脚本冲突反复回滚？生产环境升级数据库不敢停机？本文将带你用MyBatis-Plus的DDL工具结合Flyway/Liquibase实现自动化数据库版本管理，彻底解决这些痛点。读完你将获得：

3种主流数据库迁移工具的选型对比
MyBatis-Plus+Flyway的5分钟快速集成指南
分布式环境下的数据库版本冲突解决方案
完整的版本管理最佳实践清单

数据库版本管理的痛点与解决方案

在传统开发流程中，数据库变更通常通过手动执行SQL脚本完成，这种方式存在四大风险：版本混乱导致环境不一致、协同开发时脚本覆盖、生产环境升级无回滚机制、变更历史无审计追踪。

MyBatis-Plus作为增强版MyBatis工具，通过mybatis-plus-extension/src/main/java/com/baomidou/mybatisplus/extension/ddl/DdlHelper.java提供了DDL（数据定义语言）自动化执行能力，可与专业数据库迁移工具形成互补方案。

主流数据库迁移工具对比

特性	MyBatis-Plus DDL	Flyway	Liquibase
核心能力	基础DDL执行与版本记录	纯SQL脚本版本控制	多格式支持(XML/YAML/JSON/SQL)
变更方式	代码生成/脚本执行	SQL文件命名版本	变更集(ChangeSet)
回滚机制	需手动编写回滚脚本	仅专业版支持undo	原生支持回滚
社区活跃度	★★★☆☆	★★★★★	★★★★☆
集成难度	低（同MyBatis-Plus生态）	低（独立工具）	中（配置复杂）
适用场景	快速原型/简单项目	中小型团队/纯SQL场景	大型企业/多格式需求

MyBatis-Plus的DDL模块通过DdlScript.java实现了脚本执行核心功能，特别适合已使用MyBatis-Plus的项目快速集成基础版本管理能力。

MyBatis-Plus + Flyway 实战集成

环境准备

首先在项目中引入依赖（以Spring Boot为例）：

<!-- MyBatis-Plus starter -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>Latest Version</version>
</dependency>

<!-- Flyway核心包 -->
<dependency>
    <groupId>org.flywaydb</groupId>
    <artifactId>flyway-core</artifactId>
    <version>9.22.3</version>
</dependency>

目录结构规范

在src/main/resources下创建Flyway标准目录结构：

resources/
├── db/
│   └── migration/
│       ├── V1__initial_schema.sql
│       ├── V2__add_user_table.sql
│       └── U1__rollback_user_table.sql

配置文件

spring:
  flyway:
    enabled: true
    baseline-on-migrate: true  # 非空数据库首次迁移时使用
    locations: classpath:db/migration  # 脚本存放路径
    table: flyway_schema_history  # 版本记录表名
    validate-on-migrate: true  # 迁移前验证脚本

mybatis-plus:
  global-config:
    db-config:
      id-type: auto

执行迁移

启动Spring Boot应用时，Flyway会自动检测db/migration目录下的SQL脚本，按照命名规则依次执行，并在数据库中创建flyway_schema_history表记录变更历史：

-- 系统自动创建的版本记录表结构
CREATE TABLE flyway_schema_history (
    installed_rank INT NOT NULL,
    version VARCHAR(50),
    description VARCHAR(200) NOT NULL,
    type VARCHAR(20) NOT NULL,
    script VARCHAR(1000) NOT NULL,
    checksum INT,
    installed_by VARCHAR(100) NOT NULL,
    installed_on TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
    execution_time INT NOT NULL,
    success BOOLEAN NOT NULL
);

结合MyBatis-Plus代码生成器

使用MyBatis-Plus的代码生成器生成实体类后，可通过DdlHelper执行初始化脚本：

@SpringBootApplication
public class MigrationApplication implements CommandLineRunner {
    
    @Autowired
    private DataSource dataSource;
    
    public static void main(String[] args) {
        SpringApplication.run(MigrationApplication.class, args);
    }
    
    @Override
    public void run(String... args) throws Exception {
        // 使用MyBatis-Plus DdlHelper执行初始化数据脚本
        DdlHelper.runScript(null, dataSource, 
            Arrays.asList("classpath:db/data/init-data.sql"), true);
    }
}

MyBatis-Plus DDL高级特性

脚本执行流程

DdlHelper.java的核心执行逻辑如下：

检查数据库连接与版本记录表
按顺序读取SQL文件列表
通过ScriptRunner执行脚本（支持自定义分隔符）
记录执行结果到版本表

关键代码片段：

// 运行SQL脚本文件
public static void runScript(IDdlGenerator ddlGenerator, Connection connection, 
                           List<String> sqlFiles, boolean autoCommit) throws SQLException {
    runScript(ddlGenerator, connection, sqlFiles, autoCommit, 
             DdlScriptErrorHandler.PrintlnLogErrorHandler.INSTANCE);
}

多数据源支持

通过JDBC URL自动识别数据库类型：

protected static IDdlGenerator getDdlGenerator(String jdbcUrl) throws RuntimeException {
    DbType dbType = JdbcUtils.getDbType(jdbcUrl);
    if (dbType.mysqlSameType()) {
        return MysqlDdlGenerator.newInstance();
    } else if (dbType.oracleSameType()) {
        return OracleDdlGenerator.newInstance();
    } else if (DbType.SQLITE == dbType) {
        return SQLiteDdlGenerator.newInstance();
    } else if (dbType.postgresqlSameType()) {
        return PostgreDdlGenerator.newInstance();
    }
    throw new RuntimeException("Unsupported database type: " + jdbcUrl);
}

目前支持MySQL、Oracle、PostgreSQL、SQLite等主流数据库，可通过实现IDdlGenerator接口扩展其他数据库类型。

最佳实践与避坑指南

脚本命名规范

使用V{版本}__{描述}.sql格式命名（如V1.0.1__add_order_index.sql）
版本号建议使用语义化版本（主版本.次版本.修订号）
描述使用下划线分隔的小写字母，避免特殊字符

变更集设计原则

原子性：每个脚本只做一件事（如创建一个表或添加一个字段）
幂等性：确保脚本可重复执行（使用CREATE TABLE IF NOT EXISTS等语法）
可回滚：为每个变更提供对应的回滚方案
不包含业务数据：版本脚本仅处理结构变更，测试数据通过单独种子脚本添加

分布式环境安全措施

在多实例部署时，通过数据库锁机制确保版本执行顺序：

// DdlHelper中通过数据库锁保证并发安全
try (Connection connection = dataSource.getConnection()) {
    connection.setAutoCommit(false);
    // 获取数据库锁
    executeLockStatement(connection);
    // 执行迁移操作
    runMigrationScripts(connection);
    connection.commit();
}

总结与展望

MyBatis-Plus的DDL模块为项目提供了轻量级数据库版本管理能力，通过与Flyway/Liquibase等专业工具结合，可满足从简单到复杂项目的全场景需求。核心价值在于：

降低集成门槛：利用现有MyBatis-Plus生态，无需额外学习成本
灵活组合方案：基础功能用MyBatis-Plus DDL，高级需求集成专业工具
完善审计追踪：通过DdlHelper记录完整变更历史

随着项目发展，可逐步演进为"代码生成器 + MyBatis-Plus DDL + Flyway"的全链路解决方案，实现从实体类到数据库表结构的全自动管理。

扩展阅读：官方文档README-zh.md、企业版特性Mybatis-Mate

如果觉得本文有帮助，欢迎点赞收藏关注三连！下期将带来《MyBatis-Plus代码生成器与数据库版本管理联动方案》。

【免费下载链接】mybatis-plus An powerful enhanced toolkit of MyBatis for simplify development 项目地址: https://gitcode.com/gh_mirrors/my/mybatis-plus

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考