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

问题描述

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官网文档。

解决方案

这个问题主要出现在5.6版本中。5.6版本的innodb大长度前缀默认是关闭的，而5.7之后大文件前缀默认是开启的。
所以，首先需要将innodb_large_prefix参数值修改为ON，修改后对于Dynamic和Compressed格式的InnoDB引擎表，其支持的最大索引字段长度为3072字节：

show variables like "innodb_large_prefix";
# 开启
set global innodb_large_prefix=on;

然后，对于创建新表，指定表的Row Format为Dynamic或Compressed，示例如下。

create table 表名 (
   id int auto_increment primary key, 
   name varchar(255)
) ROW_FORMAT=DYNAMIC default charset utf8mb4;

对于已经创建的表，如果Row_format值不为DYNAMIC和COMPRESSED，则修改。

# 查看Row_format
show table status like 表名

# 根据实际情况，修改Row_format值(二选一执行)
alter table [$Table_Name] Row_format=dynamic;
alter table [$Table_Name] Row_format=compressed;