解决Hibernate执行DDL报错：外键约束列不兼容问题

核心问题分析 #

报错提示外键列fk_xxxx_id和引用的主键列xxxx_id类型不兼容，结合你的代码和配置，主要有以下几个问题：

1. 实体类命名混乱+拼写错误：两个实体类都叫yyyyEntity，完全重复会导致Hibernate映射混乱；第一个实体类的OneToMany关联集合类型是yyyyntity（拼写缺失字母），类型不匹配。
2. Hibernate方言与MySQL版本不匹配：你用的是MySQL 8.x驱动（com.mysql.cj.jdbc.Driver），但配置了旧版的MySQLDialect，这会导致Hibernate生成的DDL不符合MySQL 8.x规范，尤其是自增列的处理逻辑。
3. 冗余配置项：application.properties重复配置了两次spring.jpa.hibernate.ddl-auto=update，属于无效冗余。

分步解决方案 #

1. 修正实体类命名和拼写错误 #

确保实体类名称唯一，关联关系类型正确：

修正后的XxxxEntity（对应表xxxxs）

@Entity
@Table(name = "xxxxs")
public class XxxxEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long xxxx_id;

    private String name;

    @Temporal(TemporalType.TIMESTAMP)
    @Column(name = "registration_date")
    private Date registrationDate;

    @Column(name = "success_rate")
    private Double successRate;
    
    // 修正关联集合的类型为正确的YyyyEntity
    @OneToMany(mappedBy = "xxxx", cascade = CascadeType.ALL, fetch = FetchType.LAZY)
    private List<YyyyEntity> yyyys;

    // 补充getter、setter及必要构造方法
}

修正后的YyyyEntity（对应表yyyys）

@Entity
@Table(name = "yyyys")
public class YyyyEntity {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long yyyy_id;

    // 显式指定外键列类型为bigint，确保与主键类型一致
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "fk_xxxx_id", referencedColumnName = "xxxx_id", columnDefinition = "bigint")
    private XxxxEntity xxxx;

    // 补充getter、setter及必要构造方法
}

2. 修正Hibernate方言配置 #

将application.properties中的方言替换为MySQL 8.x对应版本：

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
# 替换为适配MySQL 8.x的方言
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL8Dialect

3. 清理数据库旧结构（推荐） #

如果数据库已生成错误的外键约束或列类型，建议手动执行以下操作：

• 删除yyyys表中的外键约束fk_yyyy_xxxx；
• 删除yyyys表中的fk_xxxx_id列；
• 重启应用，让Hibernate重新生成正确的表结构和外键。

额外注意事项 #

• 确保MySQL服务器版本为8.x及以上，与驱动版本匹配；
• 保持实体类名称与表名的对应关系清晰，避免重复命名；
• 使用GenerationType.IDENTITY时，方言必须正确才能让Hibernate生成符合数据库要求的自增列DDL。

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