Spring Boot集成MySQL8+出现索引过长max key length 1000 bytes报错

问题根因 #

• 配置的MySQL5Dialect不适配MySQL8版本，自动建表时默认使用MyISAM存储引擎，该引擎单字段索引最大长度限制为1000字节
• 实体类username字段设置长度为500，MySQL8默认使用utf8mb4字符集，单字符占4字节，500长度的字段总大小为2000字节，添加唯一约束时超出索引长度限制，触发报错。

修复方案 #

方案1（推荐）：更换Hibernate方言 #

修改application.properties中的方言配置，替换为MySQL8专属方言，自动使用InnoDB存储引擎：

# 替换原有的hibernate.dialect配置项
spring.jpa.properties.hibernate.dialect = org.hibernate.dialect.MySQL8Dialect

InnoDB引擎单字段索引最大长度为3072字节，500长度的utf8mb4字段总大小为2000字节，符合长度要求，可直接解决报错。

方案2（性能优化可选）：缩短字段长度 #

业务场景下用户名无需500长度，可调整字段长度到255以内，进一步提升索引查询效率：

// 修改UserAccount实体类的username字段注解
@Column(unique = true, length = 100)
private String username;

内容的提问来源于stack exchange，提问作者Jeff Cook