SpringBoot JPA配置实体关联后MySQL提示receipt表无法创建问题排查

问题原因 #

你遇到的receipt表无法创建的问题，核心原因有3个：

1. 字段名使用了MySQL保留关键字 #

Receipt实体类中的usage字段名是MySQL官方保留关键字（常用于权限授予语句GRANT USAGE），Hibernate生成建表SQL时未对该字段做特殊处理，导致建表语句语法错误，表创建失败，后续执行添加外键的DDL时自然找不到receipt表。

2. 命名不规范与JPA默认命名策略冲突 #

• 你在Receipt的@JoinColumn中显式指定外键列名为problemId，但Spring Boot集成Hibernate的默认命名策略会自动将驼峰命名转为下划线小写格式problem_id，和你指定的列名、冗余的diseaseId字段不匹配，触发建表异常。
• delivery_Date字段混合使用下划线和大写，不符合驼峰命名规范，也会被命名策略转换为不符合预期的列名，导致语法错误。

3. 数据库方言不匹配 #

你使用的MySQL驱动版本为8.0.26，但JPA配置的方言是适配MySQL5.x版本的org.hibernate.dialect.MySQL5Dialect，低版本方言和高版本MySQL存在语法兼容问题，也可能导致建表失败。

解决方案 #

• 转义或重命名保留关键字字段：给usage字段添加@Column(name = "usage")注解用反引号转义，或者直接将字段名改为非关键字（如drugUsage）。
• 统一外键命名：删除Receipt类中冗余的diseaseId字段，关联字段会自动维护外键；如果需要显式指定外键列名，可调整@JoinColumn(name = "problem_id")匹配默认命名策略。
• 更换适配的方言：将spring.jpa.database-platform配置改为org.hibernate.dialect.MySQL8Dialect适配MySQL8.x版本。
• 规范字段命名：将delivery_Date改为驼峰格式deliveryDate，依赖Hibernate自动转换为下划线格式的数据库列名。

你可以向上翻看启动日志中的SQL输出，就能看到创建receipt表时的具体语法错误，可用来验证上述判断。

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