MySQL 5.6 创建数据表时出现1071错误，缘由分析及解决办法

零、问题的背景

---

在初学SpringBoot + Angular时，数据库软件依然使用的MySQL，不一样之处在于，此次的MySQL服务再也不使用XAMPP搭建，而使用了更加方便的Docker来提供服务。

---

1、问题复现

---

在配置数据库时，用Docker搭建好环境以后，开始创建第一张数据表

而后按照教程中的查询语句新建查询
（教程地址：https://www.kancloud.cn/yunzh...）

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for teacher
-- ----------------------------
DROP TABLE IF EXISTS `teacher`;
CREATE TABLE `teacher` (
  `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT '' COMMENT '姓名',
  `sex` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '0男，1女',
  `username` varchar(255) NOT NULL COMMENT '用户名',
  `email` varchar(255) DEFAULT '' COMMENT '邮箱',
  `create_time` bigint(11) unsigned NOT NULL DEFAULT '0' COMMENT '建立时间',
  `update_time` bigint(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `nx1HkMqiUveGnJz5lHE7mEcFI5WVew3iXbv3HCwF` (`username`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4;

-- ----------------------------
-- Records of teacher
-- ----------------------------
BEGIN;
INSERT INTO `teacher` VALUES (1, '张三', 1, 'zhangsan', 'zhangsan@mail.com', 1569721598000, 1569721598000);
INSERT INTO `teacher` VALUES (2, '李四', 0, 'lisi', 'lisi@yunzhi.club', 1569721598000, 1569721598000);
COMMIT;

SET FOREIGN_KEY_CHECKS = 1;

将代码复制到查询窗口

却出现了以下提示：
1071 - Specified key was too long; max key length is 767 bytes, Time: 0.001000s

按照惯例，遇到报错先翻译
错误信息为：“指定的关键字太长；最大关键字长度为767字节”

---

2、产生缘由

---

查阅资料后，在一篇博客中发现：

若是启用了系统变量innodb_large_prefix（MySQL 5.6.41,默认是关闭的，MySQL 5.7默认开启），则对于使用DYNAMIC或COMPRESSED行格式的InnoDB表，索引键前缀限制为3072字节。若是禁用innodb_large_prefix，则对于任何行格式的表，索引键前缀限制为767字节。尝试使用超出限制的索引键前缀长度会返回错误。
注意：上面是767个字节，而不是字符，具体到字符数量，这就跟字符集有关。GBK是双字节的，UTF-8是三字节的
（引用自：https://www.cnblogs.com/kerry...）

那么缘由就很好分析了，教程中的数据表是utf8mb4，是四字节的，再看数据表中最长的字段，长度为255，255 * 4 = 1020 > 767，所以才会报错。

`username` varchar(255) NOT NULL COMMENT '用户名',
  `email` varchar(255) DEFAULT '' COMMENT '邮箱',

---

3、解决方法

---

一、减少字段长度

当了解原理以后，最早想到的就是尝试减少字段长度，来验证理论的正确性。

SET NAMES utf8mb4;
SET FOREIGN_KEY_CHECKS = 0;

-- ----------------------------
-- Table structure for teacher
-- ----------------------------
DROP TABLE IF EXISTS `teacher`;
CREATE TABLE `teacher` (
  `id` bigint(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(128) DEFAULT '' COMMENT '姓名',
  `sex` tinyint(1) unsigned NOT NULL DEFAULT '0' COMMENT '0男，1女',
  `username` varchar(128) NOT NULL COMMENT '用户名',
  `email` varchar(128) DEFAULT '' COMMENT '邮箱',
  `create_time` bigint(11) unsigned NOT NULL DEFAULT '0' COMMENT '建立时间',
  `update_time` bigint(11) unsigned NOT NULL DEFAULT '0' COMMENT '更新时间',
  PRIMARY KEY (`id`),
  UNIQUE KEY `nx1HkMqiUveGnJz5lHE7mEcFI5WVew3iXbv3HCwF` (`username`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=3 DEFAULT CHARSET=utf8mb4;

-- ----------------------------
-- Records of teacher
-- ----------------------------
BEGIN;
INSERT INTO `teacher` VALUES (1, '张三', 1, 'zhangsan', 'zhangsan@mail.com', 1569721598000, 1569721598000);
INSERT INTO `teacher` VALUES (2, '李四', 0, 'lisi', 'lisi@yunzhi.club', 1569721598000, 1569721598000);
COMMIT;

SET FOREIGN_KEY_CHECKS = 1;

把全部的255都减半，改成128， 128 * 4 = 512 < 767
再次运行查询语句以后，顺利经过。

二、将MySQL版本升级到5.7以上

我分别在MySQL5.六、5.七、Latest版本上运行了这段查询语句。经测试，5.7和Latest版本均不存在此问题，说明5.7以上版本确实默认开启了innodb_large_prefix。

三、手动开启innodb_large_prefix

须要知足下面几个条件（参考https://www.cnblogs.com/kerry...）：
1： 系统变量innodb_large_prefix为ON
2： 系统变量innodb_file_format为Barracuda
3： ROW_FORMAT为DYNAMIC或COMPRESSED

---

4、总结

---

一、版本

教程中提到，MySQL使用5.6版本和5.7版本，并无影响，事实上此次发现的问题，说明了不一样版本的MySQL仍是有许多区别的。

二、XAMPP内置的MySQL和MariaDB

那么，在以前使用XAMPP时，使用的应该就是MySQL5.6啊，为何没有出现这个错误呢？

去XAMPP官网上面一看，才忽然发现，如今的XAMPP集成的并非MySQL，而是早就换成了它的分支——MariaDB！

但是，新版的软件里面写着的，就是MySQL啊？
抱着刨根问底的态度，我打开了XAMPP的控制台，在命令行中输入mysql
结果证明了，确实换成了MariaDB！。