Spring Boot银行系统开发：Hibernate执行DDL语句报错求助

问题根源 #

这个报错是因为MySQL对索引长度有默认限制（默认1000字节），如果你的主键字段用了utf8mb4字符集（每个字符占4字节），字段长度设得太大（比如255），255*4=1020就超出了1000字节限制，Hibernate自动生成DDL时就会触发这个错误。

直接可用的解决办法 #

1. 缩短主键字段长度 #

修改Compte抽象类里的主键注解，把长度调小到249以内：

// 原来可能的写法（超限制）
@Id
@Column(length = 255)
private String id;

// 修改后
@Id
@Column(length = 249) // 249*4=996字节，刚好不超1000
private String id;

如果用的是联合主键，要确保所有主键字段的字节总和不超过1000。

2. 换用utf8字符集 #

如果你的系统不需要存储emoji这类特殊字符，直接在配置文件里把数据库连接的字符集改成utf8（每个字符占3字节）：

# application.properties配置
spring.datasource.url=jdbc:mysql://localhost:3306/你的数据库名?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

这样就算字段长度是255，255*3=765，远低于1000的限制。

3. 开启MySQL的大索引支持（适合必须用utf8mb4的情况） #

如果一定要用utf8mb4存储特殊字符，修改MySQL的配置文件（my.cnf或my.ini）：

[mysqld]
innodb_large_prefix=ON
innodb_file_format=Barracuda
innodb_file_per_table=ON

修改后重启MySQL服务，InnoDB的索引最大长度会提升到3072字节，直接解决限制问题。

4. 手动编写DDL替代Hibernate自动生成 #

嫌自动生成麻烦的话，直接关掉Hibernate的DDL自动生成，自己写建表语句：

# 关闭自动DDL生成
spring.jpa.hibernate.ddl-auto=none

然后编写符合要求的建表SQL：

CREATE TABLE compte (
    id VARCHAR(255) NOT NULL,
    -- 其他字段根据实体类补充
    PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 ROW_FORMAT=DYNAMIC;

ROW_FORMAT=DYNAMIC会让InnoDB使用变长存储，避免索引长度超限。

新手小提示 #

可以开启Hibernate的SQL日志，方便查看自动生成的DDL内容，排查问题更直观：

spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

内容的提问来源于stack exchange，提问作者Borel Mba