使用@MappedSuperclass与@ManyToOne时的列名映射问题排查

最近在HR系统的JPA继承结构里踩了个坑：数据库里所有关联员工的表都有business_group_id和employee_number字段，为了规范实体结构我搭了一套基类+实体类的框架，但启动Spring单元测试时，HierarchyEmployee直接抛出org.hibernate.MappingException，说在mpy_employees表找不到business_group_id列，翻日志一看，Hibernate居然生成了businessGroup列，完全不是我要的下划线格式。折腾了一阵终于找到解决办法，分享给你：

先揪出问题根源 #

1. 重写方法搞乱了映射元数据：AbstractHasEmployee重写了父类AbstractHasBusinessGroup的getBusinessGroupId()方法，虽然两个方法都加了@Transient，但Hibernate解析继承结构时还是被搞晕了，错误地处理了businessGroup字段的映射规则。
2. 拼写错误的关联列名：AbstractHasEmployee里的employee字段用了@JoinColumns，其中第一个列名写成了business_group_jd（明显手滑打错了，应该是business_group_id），这直接导致Hibernate去关联不存在的列，还和EmployeeId里的business_group_id产生了映射冲突。
3. 被注释的注解藏着坑：HierarchyEmployee里被注释的@Table注解中，uniqueConstraints用了驼峰式的businessGroup当列名，而数据库实际是business_group_id，要是哪天打开这个注释，直接就炸了。
4. 命名策略没生效：如果没显式配置Hibernate的物理命名策略，默认的转换逻辑可能因为继承结构的复杂情况失效，导致驼峰字段没转成下划线列名。

一步步解决问题 #

1. 修正@JoinColumns的拼写错误 #

把AbstractHasEmployee里写错的列名改回来，确保关联的是正确的数据库列：

@ManyToOne(cascade = CascadeType.ALL, optional = false)
@JoinColumns({ 
    @JoinColumn(name = "business_group_id", referencedColumnName = "business_group_id"), 
    @JoinColumn(name = "employee_number", referencedColumnName = "employee_number") 
})
private Employee employee;

2. 理顺getBusinessGroupId()的定义，避免重写冲突 #

AbstractHasBusinessGroup已经定义了@Transient的getBusinessGroupId()，AbstractHasEmployee没必要再重写它——这只会给Hibernate添乱。要么删掉子类的重写方法，要么统一通过EmployeeId获取业务组ID，同时确保父类的方法不会干扰字段映射。

3. 显式配置Hibernate的物理命名策略 #

在Spring配置文件里加上这个配置，强制让Hibernate把驼峰字段转成下划线列名：

application.properties 版本

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

application.yml 版本

spring:
  jpa:
    hibernate:
      naming:
        physical-strategy: org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy

这个配置能确保businessGroup字段被自动映射成business_group_id，和数据库列名完全匹配。

4. 修正HierarchyEmployee的@Table注解（如果要启用的话） #

要是以后需要打开@Table注解，记得把uniqueConstraints里的businessGroup改成business_group_id：

@Entity 
@Table(name = "web_approval_struct", uniqueConstraints = @UniqueConstraint(columnNames = {"employee_number", "business_group_id", "hierarchy_name"}) )

5. 简化EmployeeId的映射配置（可选但推荐） #

EmployeeId作为@Embeddable类，用@PrimaryKeyJoinColumn关联BusinessGroup实体有点复杂，容易引发映射冲突。不如改成直接存储business_group_id字符串，减少关联复杂度：

@SuperBuilder(toBuilder = true) 
@AllArgsConstructor(staticName = "from") 
@NoArgsConstructor 
@Getter @Setter @EqualsAndHashCode @ToString 
@Embeddable
public class EmployeeId implements Serializable {
    private static final long serialVersionUID = -3733372990919290775L;
    
    @Column(name = "business_group_id", nullable = false, length = 15)
    private String businessGroupId;
    
    @Column(name = "employee_number", nullable = false, length = 30)
    private String employeeNumber;
    
    public String getBusinessGroupId() { return businessGroupId; }
}

这样修改后，Employee实体的@EmbeddedId直接对应数据库的两个字符串列，映射逻辑更清晰，也不容易出问题。

最后验证一下 #

1. 先清掉项目的编译目录（比如target），重新编译代码，避免缓存的旧映射元数据搞事情。
2. 启动单元测试，看Hibernate生成的SQL语句，确认business_group_id列被正确使用，而不是businessGroup。
3. 检查数据库表结构，确保所有关联列的名称和数据库里的一致。

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