零、问题的背景

---

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

---

一、问题复现

---

在配置数据库时，用 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 字节”

---

二、产生原因

---

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

如果启用了系统变量 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' 邮箱 ',

---

三、解决方法

---

1、减小字段长度

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

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
再次运行查询语句之后，顺利通过。

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

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

3、手动开启 innodb_large_prefix

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

---

四、总结

---

1、版本

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

2、XAMPP 内置的 MySQL 和 MariaDB

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

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

可是，新版的软件里面写着的，就是 MySQL 啊？
抱着刨根问底的态度，我打开了 XAMPP 的控制台，在命令行中输入 mysql

结果证实了，确实换成了 MariaDB！。