执行建表sql提示Specified-key-was-too-long

偶尔建表时提示“Specified key was too long; max key length is 767 bytes”字样。

话不多说，见图：显示就是报错信息

image.png

这种提示我所知道有2种信息：

• 对于ENGINE=INNODB提示: Specified key was too long; max key length is 767 bytes
• 对于ENGINE=MYISAM提示: Specified key was too long; max key length is 1000 bytes
  其他存储引擎没有测试，还不知道。后续再补充吧......

示例sql：

DROP TABLE IF EXISTS `test`;
CREATE TABLE `test` (
  `id` bigint(20) NOT NULL,
  `ad_id` varchar(255) NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_ad_id` (`ad_id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8mb4;

目前我所知道的原因：

1. 字符集：建表sql中CHARSET参数
2. 索引涉及字段长度设置
3. mysql数据本身设置

原因1：字符集CHARSET

解决办法：指定字符集为utf8: ENGINE=INNODB DEFAULT CHARSET=utf8;
示例sql：

DROP TABLE IF EXISTS `test`;
CREATE TABLE `test` (
  `id` bigint(20) NOT NULL,
  `ad_id` varchar(255) NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_ad_id` (`ad_id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8;

如果数据表需要存储表情等复杂情况，必须使用CHARSET=utf8mb4时就不能这么改了，从别的原因入手。

• 扩展：mysql中utf8不是真正的utf8，utf8只支持每个字符最多三个字节，而真正的 utf8 是每个字符最多四个字节
  mysql一直没有修复这个 bug，他们在 2010 年发布了utf8mb4的字符集，这个字符集才是真正的utf8

原因2：索引涉及字段长度

就如示例中索引idx_ad_id的涉及字段：ad_id 类型为varchar(255)
如果业务允许，字段长度可以不用太长。可以设置短一点。例如varchar(64)
示例sql：

// ENGINE=INNODB
DROP TABLE IF EXISTS `test`;
CREATE TABLE `test` (
  `id` bigint(20) NOT NULL,
  `ad_id` varchar(64) NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_ad_id` (`ad_id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8mb4;

或
// ENGINE=MYISAM
DROP TABLE IF EXISTS `test`;
CREATE TABLE `test` (
  `id` bigint(20) NOT NULL,
  `ad_id` varchar(64) NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_ad_id` (`ad_id`)
) ENGINE=MYISAM DEFAULT CHARSET=utf8mb4;

扩展：既然varchar(64)可以，而varchar(255)。那么，这个长度临界值(边界值)是多少？

多次测试，不同存储引擎临界值不同。

1. 对于ENGINE=INNODB，发现临界值为varchar(191)。眼见为实：
   对于varchar(191)截图：
   
   image.png

对于varchar(192)截图：很明下报错

image.png

由此得知：对于ENGINE=INNODB提示: Specified key was too long; max key length is 767 bytes

2. 对于ENGINE=MYISAM，发现临界值为varchar(191)。眼见为实：
   对于varchar(250)截图：
   
   image.png

对于varchar(251)截图：很明下报错

image.png

由此得知：对于ENGINE=MYISAM提示: Specified key was too long; max key length is 1000 bytes

当然对于以上测试的2种情况，不一定每个环境都相同。可能由于mysql配置情况，即使varchar(255) 或 varchar(64)也会出现类似问题。这就得再仔细研究了。

原因3：mysql数据库本身设置

如果以上2种原因相应解决办法都不能解决，那只能从mysql配置入手。

• 对于innodb格式：

1. 修改配置
   1.1. 查看：show variables like "%innodb_file%";
   
   image.png
   
   1.2. 修改为以下值:

innodb_file_format=barracuda    
innodb_file_per_table=true    
innodb_large_prefix=true 

具体修改方法可以找度娘或是找运维小哥哥，这里就不贴了。

2. 在建表时指定row format 格式为 Dynamic 或者 Compressed
   示例：

DROP TABLE IF EXISTS `test`;
CREATE TABLE `test` (
  `id` bigint(20) NOT NULL,
  `ad_id` varchar(255) NOT NULL,
  PRIMARY KEY (`id`),
  KEY `idx_ad_id` (`ad_id`)
) ENGINE=INNODB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC;

• 对于myisam：
  还不知道咋修改，估计也是类似只是不同参数字段。以后再补充吧

注意：由于数据库环境不同，修改一定要注意。
比如，数据库是主从，多集群。那么修改一个，其他都需要修改。涉及的范围就不是一点半点了。正所谓牵一发而动全身

相同错误也可能有其他情况导致，这里暂时记录下已知问题。