如何在Liquibase中定义前缀索引作为主键？

当然可以实现，针对你遇到的Specified key was too long; max key length is 3072 bytes错误，下面是两种实用方案：

方案一：给主键加前缀索引 #

这是最常用的折中方案，利用MySQL支持的字符串前缀索引特性，通过Liquibase可直接配置：

1. 新建表时定义前缀主键 #

如果是刚创建表，两种实现方式：

• 用Liquibase XML语法，配合索引定义明确前缀长度：

<changeSet id="create_long_key_table" author="your_name">
    <createTable tableName="long_key_table">
        <column name="long_column" type="VARCHAR(2000)">
            <constraints primaryKey="true" nullable="false"/>
        </column>
    </createTable>
    <!-- 显式指定前缀长度创建唯一主键索引 -->
    <createIndex indexName="pk_long_column" tableName="long_key_table" unique="true">
        <column name="long_column" type="VARCHAR(767)"/> <!-- utf8编码下767字节是安全的前缀长度 -->
    </createIndex>
</changeSet>

• 直接写SQL语句，灵活性更高：

<changeSet id="create_pk_with_prefix" author="your_name">
    <sql>
        CREATE TABLE long_key_table (
            long_column VARCHAR(2000) NOT NULL,
            PRIMARY KEY (long_column(767))
        ) ENGINE=InnoDB DEFAULT CHARSET=utf8;
    </sql>
</changeSet>

2. 修改已有表的主键为前缀索引 #

如果是已存在的表，先删除旧主键再创建新的前缀主键：

<changeSet id="update_existing_pk" author="your_name">
    <!-- 删除原有主键约束 -->
    <dropPrimaryKey tableName="your_table" constraintName="old_pk_constraint"/>
    <!-- 添加带前缀的新主键 -->
    <addPrimaryKey tableName="your_table">
        <column name="long_column" type="VARCHAR(767)"/>
    </addPrimaryKey>
</changeSet>

嫌XML步骤繁琐的话，直接用SQL一步到位：

<changeSet id="modify_pk_via_sql" author="your_name">
    <sql>
        ALTER TABLE your_table DROP PRIMARY KEY;
        ALTER TABLE your_table ADD PRIMARY KEY (long_column(767));
    </sql>
</changeSet>

方案二：扩大MySQL的索引长度限制 #

如果业务必须使用完整长度的主键，可以调整InnoDB引擎参数，但前提是你拥有数据库超级权限：

通过Liquibase执行SQL修改全局参数和表属性：

<changeSet id="adjust_innodb_settings" author="your_name">
    <!-- 开启大前缀支持（需超级权限） -->
    <sql>
        SET GLOBAL innodb_large_prefix = ON;
        SET GLOBAL innodb_file_format = Barracuda;
        SET GLOBAL innodb_file_per_table = ON;
    </sql>
    <!-- 修改表为动态行格式，支持更长索引 -->
    <sql>
        ALTER TABLE your_table ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC;
    </sql>
    <!-- 重新创建完整长度的主键 -->
    <sql>
        ALTER TABLE your_table DROP PRIMARY KEY;
        ALTER TABLE your_table ADD PRIMARY KEY (long_column);
    </sql>
</changeSet>

注意：上述全局参数修改是临时生效的，要永久生效需修改MySQL配置文件（my.cnf/my.ini），添加以下内容后重启MySQL：

innodb_large_prefix = ON
innodb_file_format = Barracuda
innodb_file_per_table = ON

关键提醒 #

• 前缀索引的长度要根据实际数据分布测试确定：太短可能导致重复值主键冲突，太长则会回到原错误。
• 调整InnoDB大前缀参数要求MySQL 5.7+或MariaDB 10.2+版本，老版本不支持该特性。

内容的提问来源于stack exchange，提问作者Azianese