遇到个MySQL索引长度限制的问题-技术快报

遇到个MySQL索引长度限制的问题

发布时间：2025-11-03 23:49:18 来源：技术快报作者：应用开发

我只是索引创建个索引而已，没想到还这些遇到个诡异的长度问题！

话说你平时创建mysql时遇到过以下创建索引报错的限制情况吗？

报错提示如下

🚩什么？索引长度限制？我从没遇到过啊，MySQL还会对索引键的索引长度有限制？

是的，一般都不会遇到，长度不过这个问题我一个同事就遇到了！限制

他用同样表结构和加索引的索引语法，都是长度相同的，但是限制一个测试环境和一个线上MySQL版本，一个执行成功一个执行失败！索引

事故现场：

同事A的长度迭代开发测试完了，准备将环境放到预发布了，限制在添加索引的索引时候居然创建索引报错了，瞬间一脸郁闷，长度我测试过得了啊！限制

是的，没错，虽然测过了，b2b信息网但是因为版本不同，在为数据库字段类型(varchar(255))创建索引的时候，指定的字段有可能会超过了存储引擎默认的长度！

当然你会问，为啥要为varchar(255)创建索引啊，这个就不多追问了！

不过刚好趁对这个问题有印象，今天可以聊聊MySQL单表对索引限制的知识点!

既然MySQL 对每个单表中所创建的索引长度是有限制，我们先看下不同的存储引擎下对表的限制是什么样的。

图片

• 单列索引：最大长度不能超过 1000 bytes，否则会报警，但是创建成功，最终创建的是前缀索引（取前333个字符）。

• 联合索引：索引长度和不能超过 1000 bytes，否则会报错，创建失败

• 单列索引：超过 767 bytes的，给出warning，最终索引创建成功，网站模板取前缀索引（取前 255 字符）

• 联合索引：各列长度不超过 767 字节，如果有超过 767 bytes 的，则给出报警，索引最后创建成功，但是对于超过 767 字节的列取前缀索引，与索引列顺序无关，总和不得超过 3072 ，否则失败，无法创建

默认情况下utf编码一个字符占三个字节，也就是说在InnoDB引擎中，4个varchar(255)字段就把单表索引长度给占满了哦！

3072 / 767 约等于 4，而varchar(255)，在utf8编码下是765字节，因此四个varchar(255)字段就快超过综合3072了

图片

MySQL5.5 版本：引入了 innodb_large_prefix，用来禁用大型前缀索引，以便与不支持大索引键前缀的早期版本的 InnoDB 兼容

开启 innodb_large_prefix 可以使单索引的长度限制达到 3072 字节（但是联合索引总长度限制还是 3072 字节），禁用时单索引的长度限制为 767 字节

MySQL5.7： MySQL5.5版本与MySQL5.6 版本，innodb_large_prefix 是默认关闭的，在 MySQL5.7 及以上版本则默认开启

若行格式为 DYNAMIC 或 COMPRESSED 时，限制值为 3072，而行格式 REDUNDANT 或 COMPACT 时，限制值为 767。

MySQL在5.7及以上版本在InnoDB引擎中默认行格式是 DYNAMIC，所以限制长度为3072字节。

了解完存储引擎和不同MySQL版本对索引长度的限制，我们以InnoDB引擎为例，看MySQL不同的字符集对索引长度有啥影响。

未开启 innodb_large_prefix

图片

未开启 innodb_large_prefix

MySQL5.7默认开启了innodb_large_prefix，或者更高版本，比如MySQL8

图片

UTF8编码占用3个字节，能表示除了表情符之外的其他字符，UFT8mb4占用4个字节，既能表示汉字也能表示表情符。

针对这个问题，一般来说可以考虑一下几种方式去处理

• 将varchar(255)字段改成更小的字符长度类型

• 如果是MySQL5.5版本与MySQL5.6 版本，可以启用innodb_large_prefix参数,来使得单个索引字段的长度突破767

• 这种大字段类型可以考虑前缀索引

毕竟varchar(255)这种长度的类型作为索引相对来说并不是那么合适！

随便看看