Spring Boot中Hibernate自动建表报错：DDL执行失败及字段重复

问题原因分析 #

1. 重复字段问题 #

数据库表字段采用大驼峰命名（如Maphong、SoTang），而Hibernate默认物理命名策略会将实体类驼峰字段转换为下划线小写格式（如ma_phong、so_tang）。若实体类未显式指定与数据库字段的映射关系，Hibernate会将转换后的下划线字段判定为新字段，最终在数据库中生成重复字段。

2. DDL执行错误 #

Hibernate启动时尝试将hokhau表的maphong字段长度修改为varchar(255)，但该字段被nhankhau表的外键约束nhankhau_ibfk_1引用。MySQL规则限制：被外键关联的字段无法直接修改结构，必须先移除外键约束才能调整字段属性。

解决方案 #

一、消除重复字段 #

提供两种可行方案，按需选择：

方案1：统一Hibernate命名策略

在application.properties中添加配置，让Hibernate直接使用实体类字段名作为数据库字段名（不做驼峰转下划线处理）：

spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

方案2：实体类显式映射字段

在实体类的每个字段上添加@Column注解，明确指定对应数据库的字段名：
示例Hokhau实体类：

@Entity
@Table(name = "hokhau")
public class Hokhau {
    @Id
    @Column(name = "Maphong") // 对应数据库的Maphong主键字段
    private String maphong;

    @Column(name = "SoTang") // 对应数据库的SoTang字段
    private Integer soTang;

    // 省略getter、setter方法
}

示例Nhankhau实体类：

@Entity
@Table(name = "nhankhau")
public class Nhankhau {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "MaNhanKhau")
    private Integer maNhanKhau;

    // 省略其他字段定义...

    @ManyToOne
    @JoinColumn(name = "Maphong") // 明确外键对应数据库的Maphong字段
    private Hokhau hokhau;

    // 省略getter、setter方法
}

二、修复DDL执行错误 #

步骤1：临时禁用自动表结构更新

修改application.properties中的配置，阻止Hibernate启动时修改表结构：

spring.jpa.hibernate.ddl-auto=none

步骤2：手动调整字段结构（若需要修改长度）

如果确实需要调整Maphong字段长度，按以下SQL顺序执行：

1. 删除nhankhau表的外键约束：

ALTER TABLE nhankhau DROP FOREIGN KEY nhankhau_ibfk_1;

2. 修改主表hokhau的Maphong字段长度：

ALTER TABLE hokhau MODIFY COLUMN Maphong VARCHAR(255) NOT NULL;

3. 修改从表nhankhau的Maphong字段长度（与主表保持一致）：

ALTER TABLE nhankhau MODIFY COLUMN Maphong VARCHAR(255);

4. 重新添加外键约束：

ALTER TABLE nhankhau ADD CONSTRAINT nhankhau_ibfk_1 FOREIGN KEY (Maphong) REFERENCES hokhau(Maphong);

步骤3：恢复自动更新配置（按需）

若后续需要Hibernate自动维护表结构，将spring.jpa.hibernate.ddl-auto改回update即可，但需确保实体类字段定义与数据库结构完全匹配。

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