文档首页/ 云数据库 RDS/ 故障排除/ RDS for MySQL/ 参数类/ RDS for MySQL创建索引失败报错[ERROR] 1071的解决方案
更新时间:2024-12-13 GMT+08:00

RDS for MySQL创建索引失败报错[ERROR] 1071的解决方案

场景描述

创建索引长度超限制导致创建失败。创建表索引时出现如下错误:

[ERROR] 1071 - Specified key was too long; max key length is 3072 bytes

问题可能出现的版本:MySQL-8.0.20.5

故障分析

InnoDB表引擎有限制。

默认情况下,索引前缀长度限制为 767 字节,当开启了“innodb_large_prefix”选项时,索引前缀长度扩展到 3072 字节。

SHOW VARIABLES LIKE ‘%innodb_large_prefix%’;

索引前缀长度还和 InnoDB 的 page size 有关。“innodb_page_size”选项默认是 16KB 的时候,最长索引前缀长度是 3072 字节,如果是 8KB 的时候,最长索引前缀长度是 1536 字节;4KB 的时候,最长索引前缀长度是 768 字节。

SHOW VARIABLES LIKE ‘%innodb_page_size%’;

查看问题表结构,并查询所有支持的字符集及其字节占用情况:

SHOW CHARACTER SET;

问题所在的表的字符集是 utf8mb4 时,一个字符将占用 4 个字节。这意味着索引前缀最大长度为 3072 字节时,只能容纳 3072 / 4 = 768 个字符。因此只要将上面建表语句索引字段的前缀长度设为768或者修改索引字段,让其小于3072字节。

解决方案

修改索引字段长度,即可成功创建索引。