MySQL创建索引时提示“Specified key was too long； max key length is 767 bytes”

太过爱你忘了你带给我的痛 2024-03-22 14:15 15阅读 0赞

## MySQL创建索引时提示“Specified key was too long; max key length is 767 bytes” ##

### 问题描述 ###

数据库RDS MySQL版在创建表索引时，出现如下错误信息。

*      Error 1071: Specified key was too long; max key length is 767 bytes.
 *      ERROR 1709 (HY000): Index column size too large. The maximum column size is 767 bytes.

### 问题原因 ###

*  由于MySQL的InnoDB引擎表索引字段长度的限制为767字节，因此对多字节字符集的大字段或者多字段组合，在创建索引时会出现该问题。
 *  说明
 *  以utf8mb4字符集的字符串类型字段为例。utf8mb4是4个字节字符集，默认支持的索引字段最大长度是191字符（767字节/4字节每字符≈191字符），因此在varchar(255)或char(255)类型字段上创建索引会失败。详情请参见 [MySQL官网文档][MySQL]。

### 解决方案 ###

*  请参考以下内容，将innodb\_large\_prefix参数值修改为ON，修改后对于Dynamic和Compressed格式的InnoDB引擎表，其支持的最大索引字段长度为3072字节：
 *  **说明**
 *  在MySQL 8.0中已经删除了innodb\_large\_prefix参数，您可通过调整数据表的Row\_format值来解决，具体操作请参见第3步操作。

1.  登录[RDS控制台][RDS]，选择目标地域，单击目标实例ID，单击**参数设置**，将**innodb\_large\_prefix**值修改为**ON**，单击确定，然后单击提交参数即可。![innodb\_large\_prefix][innodb_large_prefix]
2.  登录数据库，执行以下SQL语句，确认innodb\_large\_prefix值为ON。
    
        show variables like 'innodb_large_prefix';
    
    系统显示类似如下。![返回结果][0991f00e5f5e0900edeeefee7ef28e44.png]
3.  配置Row Format。
    
    **说明**
    
     *  将innodb\_large\_prefix参数值修改为ON后，对于Dynamic和Compressed格式的InnoDB引擎表，其支持的最大索引字段长度为3072字节。
     *  只支持DYNAMIC和COMPRESSED格式的表，compact格式的表不支持。
     *  创建表时配置：指定表的Row Format为Dynamic或Compressed，示例如下。
        
            create table [$Table_Name] (id int auto_increment primary key, name varchar(255)) ROW_FORMAT=DYNAMIC default charset utf8mb4;
        
        **说明** \[$Table\_Name\]为表名。
     *  修改已有表配置：
        
        1.  执行以下SQL语句，查看Row\_format取值，如果取值不是DYNAMIC和COMPRESSED，则执行后续步骤修改取值。
            
                show table status like '[$Table_Name]'\G
            
            系统显示类似如下。![返回结果2][2]
        2.  根据实际情况，执行其中一条SQL语句，修改Row\_format值。
            
                alter table [$Table_Name] Row_format=dynamic;alter table [$Table_Name] Row_format=compressed;

[MySQL]: https://dev.mysql.com/doc/refman/5.6/en/charset-unicode-utf8mb4.html
[RDS]: https://rdsnext.console.aliyun.com/rdsList/cn-huhehaote/basic
[innodb_large_prefix]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/fee7d487e15b4faea6da4d928eaf770b.png
[0991f00e5f5e0900edeeefee7ef28e44.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/f0fc245880f14f8ca27b95483be56ccd.png
[2]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/22/7d546046fc1d4950bc650a84af930cf1.png