MySQL Liquibase与MySQL自增主键不兼容的问题

阅读更多：MySQL 教程

背景

Liquibase是一个开源的、免费的数据库重构工具。它可以灵活地管理数据库中的变更，支持多种数据库，并且可以追踪和回滚数据库的变化。

MySQL是一种关系数据库管理系统，支持自增主键，该主键可以在进行INSERT操作时为该表新插入的行生成独一无二的值。

然而，使用Liquibase时，有些人发现MySQL的自增主键和Liquibase不兼容的问题。当它们一起使用时，会导致Liquibase在执行变更时生成错误的主键值。

问题描述

在Liquibase中，如果使用类似以下的ChangeSet：

<changeSet id="1" author="bob">
  <createTable tableName="person">
    <column name="id" type="int" autoIncrement="true" primaryKey="true"/>
    <column name="name" type="varchar(50)"/>
    <column name="age" type="int"/>
  </createTable>
</changeSet>

它会在MySQL中创建一个名为”person”的表，该表包含三列：id、name和age。其中，id是自增主键。

然而，当Liquibase尝试在该表中插入新行时，它会生成错误的主键值。例如，如果Liquibase尝试插入一行：

<changeSet id="2" author="bob">
  <insert tableName="person">
    <column name="name" value="Alice"/>
    <column name="age" value="25"/>
  </insert>
</changeSet>

则生成的SQL语句将是：

INSERT INTO person (id, name, age) VALUES (1, 'Alice', 25)

这样做会导致MySQL中的自增主键无法按预期自增，而是始终保持为1。

解决方法

要解决这个问题，我们需要在Liquibase中显式地设置MySQL的auto_increment_offset属性。

在Liquibase的ChangeSet中，我们可以添加一个preConditions子元素，它将在执行ChangeSet之前检查数据库的某些属性。例如，我们可以添加以下ChangeSet：

<changeSet id="3" author="bob">
  <preConditions>
    <dbms type="mysql"/>
  </preConditions>

  <sql>
    SET @@auto_increment_offset=10000;
  </sql>
</changeSet>

这将在Liquibase执行此ChangeSet之前检查数据库是否是MySQL，并将MySQL的auto_increment_offset属性设置为10000。这样做将导致MySQL在进行INSERT时跳过前10000个自增主键值，从而避免与Liquibase生成的值冲突。

但是，需要注意的是，如果我们手动插入数据时，务必确保手动插入的自增主键值不会与Liquibase生成的值重复。如果手动插入的值与Liquibase生成的值重复，将导致MySQL的自增主键偏移量被更新，从而导致后续的Liquibase操作失败。

总结

在使用Liquibase时，如果遇到与MySQL自增主键不兼容的问题，我们可以通过在Liquibase的ChangeSet中显式地设置MySQL的auto_increment_offset属性来解决。虽然这种方法可以解决Liquibase生成错误主键值的问题，但需要注意手动插入数据时避免与Liquibase生成的值冲突。