mysql建表报错:Specified key was too long 问题分类 问题描述 原因分析 解决方案


mysql,utf-8,utf8mb4

问题描述


开发环境执行项目相关的sql建表语句时正常,但是将该sql语句放到QA测试环境的数据库上执行时,出现报错:Specified key was too long:max key length is 767 bytes。

原因分析


报错提示很明显,建表语句中有一个字段是varchar(200),这样的定义在utf8mb4编码下是不允许的,utf8mb4编码下每个字符最大的字节数为4,所以很明显 4*200 > 767。

(1)查看QA环境数据库innodb_large_prefix值后,发现该值是开启的状态,如果禁用innodb_large_prefix,不管是什么表,索引键前缀限制为767字节。

(2)数据库建立时用的也是utf-8的编码

(3)大意了,一开始就判断是新环境的数据库编码格式问题或者innodb_large_prefix禁用问题,但是没想到居然是建表语句本身将 CHARSET设置为了utf8mb4,导致了该报错的发生

至于开发环境没问题,是因为该表是另一个同学新增的,开发环境没有执行到,误导了。

解决方案


将建表语句中的CHARSET=utf8mb4调整为CHARSET=utf8