【问题标题】：Error: Specified key was too long; max key length is 1000 bytes错误：指定的密钥太长；最大密钥长度为 1000 字节
【发布时间】：2012-08-04 13:51:04
【问题描述】：

错误：

1071 - 指定的密钥太长；最大密钥长度为 1000 字节

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id` , `module_id` )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

我知道发生错误是因为 255x2x3（每个字符 3 个字节）

并非所有安装都会发生这种情况。我可以更改哪些设置？

【问题讨论】：

据我所知，1000 个限制适用于 MyISAM 表。您确定这是尝试创建 InnoDB 表时造成的吗？
你用的是哪个版本的MYSQL？
版本 5.1.56 社区

标签： mysql

【解决方案1】：

NO_ENGINE_SUBSTITUTION 被禁用且 INNODB 未激活，一个错误的组合

在 MySql 5.5 之前，sqlmode 默认为空字符串，这意味着默认情况下未设置 sqlmode NO_ENGINE_SUBSTITUTION

根据 MySql 文档（参见https://dev.mysql.com/doc/refman/5.6/en/sql-mode.html#sqlmode_no_engine_substitution），这是 sqlmode NO_ENGINE_SUBSTITUTION 的含义：

控制默认存储引擎的自动替换，当 CREATE TABLE 或 ALTER TABLE 等语句指定存储禁用或未编译的引擎。

因为存储引擎可以在运行时可插拔，不可用引擎的处理方式相同：

在禁用 NO_ENGINE_SUBSTITUTION 的情况下，CREATE TABLE 是默认值发动机被使用，如果所需的发动机是不可用。对于 ALTER TABLE，会出现警告，并且该表不是改变了。

启用 NO_ENGINE_SUBSTITUTION 时，会发生错误，并且该表是如果所需的引擎不可用，则不会创建或更改。

所以：如果 NO_ENGINE_SUBSTITUTION 被禁用并且 INNODB 被关闭，如果您在 CREATE TABLE 语句中指定 INNODB，MySql 也会切换到 MISAM。
如果您正在创建的表适用于 MISAM，您只会收到警告并创建表。那不是你的情况，你的创建语句包含一个超出MYISAM 1000字节限制的索引，然后创建失败，错误1071报告MYISAM错误。那是因为工作引擎是 MISAM，而不是 INNODB。

证明

MySql 5.1.56 版社区

案例一：

Options in my.cnf  
sql-mode=""  
default-storage-engine=MYISAM  
skip-innodb uncommented (without#) 

Return on execution of your create statement:
Error Code: 1071. Specified key was too long; max key length is 1000 bytes

Explanation: INNODB is not active, the engine is automatically switched to MYISAM  
that returns this error as they key is longer than MYISAM 1000 bytes limit.  
The key length is: 
2 fields x 255 char x 3 bytes utf8 encoding + 2 x 1 length byte = 1532 bytes

案例2：

Options in my.cnf
sql-mode="NO_ENGINE_SUBSTITUTION"
default-storage-engine=MYISAM
skip-innodb uncommented (without#)

Return on execution of your create statement:
Error Code: 1286. Unknown table engine 'INNODB'

Explanation: INNODB is not active but the engine substitution is not permitted
by sql mode therefore the DB returns an error about the attempt of using a disabled engine.

案例 3：

Options in my.cnf
sql-mode="NO_ENGINE_SUBSTITUTION"
default-storage-engine=MYISAM
skip-innodb commented (with#)

Return on execution of your create statement:
Table creation OK!

Explanation: INNODB is active (skip-innodb commented) and it is used also if      
the default engine is MYISAM.

为了重现测试，在 my.cnf 中的每次更改后重新启动 MySql。

由于MySql 5.6版本的sqlmode默认不再为空并且包含NO_ENGINE_SUBSTITUTION，而且INNODB是默认引擎，所以这个错误很难遇到。

其他测试

没有其他方法可以重现错误：

Error Code: 1071. Specified key was too long; max key length is 1000 bytes

在尝试创建 INNODB 表时发现。

在 INNODB 中有两种 ERROR 1071：

Error Code: 1071. Specified key was too long; max key length is 767 bytes

这与innodb_large_prefix ON 或OFF 无关，只与用作索引的单个VARCHAR 列的大小有关。

Mysql 将 varchar utf8 存储为 3 个字节加上 1 个字节，长度最多为 255 个字符，后面为 2 个（请参阅：http://dev.mysql.com/doc/refman/5.7/en/storage-requirements.html），因此如果您尝试使用 VARCHAR(256) utf8 设置密钥，您会得到：

256 x 3 + 2 = 770 bytes

你得到了前面的错误，因为对于 InnoDB 表，单个列的最大键长度是 767 字节。 VARCHAR(255) 可以，因为：

255 x 3 + 1 = 766 bytes

我在 5.1.56、5.5.33、5.6 和 5.7 四个版本的 Mysql 上对其进行了测试，并得到了证实。 VARCHAR(255) 查询没有问题，VARCHAR(256) 有问题：

Error Code: 1071. Specified key was too long; max key length is 767 bytes

如您所见，消息不同，因为它是 INNODB 消息而不是 MISAM 消息！

INNODB 表的另一种类型的 ERROR 1071 是：

Error Code: 1071. Specified key was too long; max key length is 3072 bytes

这与具有多列的键有关。要启用这些键，您需要将 innodb_large_prefix 设置为 on。无论如何，如果你尝试运行这样的东西：

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key1` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key2` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id` , `module_id`, `action_name_key`, `action_name_key1`, `action_name_key2` )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

使用 5 VARCHAR(255) utf8 列的键，即 3830 字节，您将遇到：

Error Code: 1071. Specified key was too long; max key length is 3072 bytes

外来假设

在寻找原因的过程中，我制定并测试了不同且非常奇怪的假设：

行格式

已测试 REDUNDANT、COMPACT、COMPRESS、DYNAMIC：对您的语句创建表没有影响。

文件格式

经过测试的 Antelope 和 Barracuda：您的语句对创建表没有影响。

MySql 内置

已测试 32 位和 64 位 MySql：对您的语句创建表没有影响。

其他类似故障

在这里你可以找到相同情况下的相同错误：

https://www.drupal.org/node/2466287

我在证明中列出的 3 种测试情况中测试了该语句，它重现了与您完全相同的行为，所以我可以说问题是相同的。在那种情况下，他们切换到其他数据库，但问题是设置的混合，而不是数据库版本。

参考文献

这里给出了一篇非常好的使用 INNODB 进行索引的文章：

http://mechanics.flite.com/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071/

警告：在创建索引超过 1000 的 INNODB 表后取消注释 my.cnf 中的 skip-innodb 来禁用 INNODB 将不允许启动 MySql 服务

问候

【讨论】：

@Chris Muench，有什么反馈吗？
这似乎是最有意义的！

【解决方案2】：

我现在不知道你有多少灵活性，但这里有一些选择：

将 MySQL 版本升级到最新版本（我在 MySQL 5.5.25，没有错误。）
从 utf8 更改为 latin1。
减小构成主键的字段的大小。创建一个单独的 auto_increment 主键字段来替换现有的键。在第一个字段action_id（但不是第二个字段）上创建单独的索引

除了这些选项之外，您几乎被卡住了，因为在 MySQL 中没有可以更改的设置来启用大于 1000 字节的索引键。

【讨论】：

【解决方案3】：

在 MySQL 5.6.3+ 中存在一些限制（需要 ROW_FORMAT=DYNAMIC、innodb_file_format=BARRACUDA 和 innodb_file_per_table=true），您可以启用 innodb_large_prefix 以获得 3072 字节的密钥长度限制。

【讨论】：

【解决方案4】：

您（不小心？）关闭了 InnoDB。它正在将表创建为 MyISAM，并且整个键超过 1000 个字节。

检查您是否有 InnoDB 的变量，以及是否有“no_engine_substitution”（如果在 5.1.56 中存在的话）还要检查 mysqld.err 以查看它在启动时是否有一些相关的错误。

【讨论】：

【解决方案5】：

好像和存储引擎有关。我的最终用户使用的是 MyISAM，它以不同方式处理数据存储，从而导致该错误。

【讨论】：

原因是 INNODB 未激活且 sql 模式 NO_ENGINE_SUBSTITUTION 已禁用，请参阅我的扩展答案。问候

【解决方案6】：

如前所述，您的索引的总长度太长了。

简短的回答是，无论如何您都不应该为这么长的VARCHAR 列建立索引，因为索引会非常庞大且效率低下。

最佳做法是使用前缀索引，这样您就只索引数据的左子字符串。无论如何，您的大部分数据都将比 255 个字符短得多。

767 字节是 InnoDB 表的规定前缀限制 - MyISAM 表的长度为 1,000 字节。

根据对此问题的回复，您可以通过指定列的子集而不是整个金额来获取要应用的密钥。意味着您可以在定义索引时声明每列的前缀长度。

例如：

KEY `key_name` (`action_id`(50),`module_id`(50))

下面是一个更清楚地解释它的例子：我创建了一个表并在其中插入了一些数据。

CREATE TABLE `phppos_modules_actions` (
  `action_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `module_id` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `action_name_key` VARCHAR( 255 ) CHARACTER SET utf8 COLLATE utf8_unicode_ci NOT NULL ,
  `sort` INT NOT NULL ,
  PRIMARY KEY ( `action_id`(50) , `module_id`(50) )
) ENGINE = INNODB CHARACTER SET utf8 COLLATE utf8_unicode_ci;

但是给定列的最佳前缀长度是多少？下面是一种查找方法：

SELECT
 ROUND(SUM(LENGTH(`action_id`)<10)*100/COUNT(*),2) AS pct_length_10,
 ROUND(SUM(LENGTH(`action_id`)<20)*100/COUNT(*),2) AS pct_length_20,
 ROUND(SUM(LENGTH(`action_id`)<50)*100/COUNT(*),2) AS pct_length_50,
 ROUND(SUM(LENGTH(`action_id`)<100)*100/COUNT(*),2) AS pct_length_100
FROM `phppos_modules_actions`;


+---------------+---------------+---------------+----------------+
| pct_length_10 | pct_length_20 | pct_length_50 | pct_length_100 |
+---------------+---------------+---------------+----------------+
|         42.86 |         80.20 |        100    |         100    |
+---------------+---------------+---------------+----------------+

这告诉您 80% 的字符串少于 20 个字符，并且所有字符串少于 50 个字符。所以不需要索引超过 50 的前缀长度，当然也不需要索引 255 个字符的全长。

根据需要进行调整以获取应用密钥，但我想知道是否值得审查有关此实体的数据模型，看看是否有改进可以让您在不影响 MySQL 的情况下实施预期的业务规则限制。

可以在http://mechanics.flite.com/blog/2014/07/29/using-innodb-large-prefix-to-avoid-error-1071/找到一些关于 innodb 设置的替代方法

【讨论】：

【解决方案7】：

官方文档5.6

InnoDB 表的限制

InnoDB 内部最大 key 长度是 3500 字节，但是 MySQL 本身将此限制为 3072 字节。此限制适用于多列索引中的组合索引键。

http://dev.mysql.com/doc/refman/5.7/en/innodb-restrictions.html

MyISAM 存储引擎

最大密钥长度为 1000 字节。这也可以通过更改源并重新编译。对于密钥长于的情况 250 字节，比默认的 1024 字节更大的密钥块大小是用过。

http://dev.mysql.com/doc/refman/5.7/en/myisam-storage-engine.html

但是，您的表被声明为 InnoDB。所以我不知道该怎么想

这个old bug的最后还有一个线索

如果您需要这个，您应该真正查看 MySQL 5.5 和从 5.5.14（2011 年 7 月）开始提供的 innodb_large_prefix 选项，因为它可能满足您的需求：

"启用此选项以允许索引键前缀长度超过 767 字节（最多 3072 字节），对于使用 DYNAMIC 和压缩的行格式。（创建此类表还需要选项值 innodb_file_format=barracuda 和 innodb_file_per_table=true。）请参阅第 13.3.15 节，“InnoDB 的限制表”，用于与索引键前缀相关的相关最大值在各种设置下。

【讨论】：

【解决方案8】：

最大密钥长度为 1000 字节。这也可以通过更改源并重新编译来更改。对于长度超过 250 字节的密钥，使用比默认值 1024 字节更大的密钥块大小。

【讨论】：

【解决方案9】：

在我的例子中，MySQL 是在没有 InnoDB 支持的情况下启动的。在数据库备份导入期间 - 尝试创建 MyISAM 表。

同时，在 MySQL 重启过程中，控制台没有显示错误。
只有在检查 MySQL 日志文件时 - 才发现这个。

顺便说一句，错误与 innodb_log_file_size = 4G 相关，仅当将其更改为 innodb_log_file_size = 1G - InnoDB 支持已启用。

【讨论】：