Hibernate MappingException：外键列数与引用主键不匹配问题求助

嘿，看起来你在使用JPA和Hibernate保存数据时碰到了映射问题，我来帮你拆解下这个报错的原因和解决思路～

首先，先把你遇到的错误信息贴出来，方便定位核心问题：

Caused by: org.hibernate.MappingException: Foreign key (FKi3uxs48nod3arim7hhpwx1anb:role_group [app_group_id])) must have same number of columns as the referenced primary key (app_group [id, app_id, group_id])

从错误信息就能直接抓到关键：你的role_group表中用来关联app_group的外键只有app_group_id这一列，但app_group表的主键是由id、app_id、group_id三列组成的复合主键。Hibernate对外键的匹配要求很严格——外键的列数必须和被引用的主键列数完全一致，这就是你报错的根本原因。

接下来给你几个具体的解决方向，你可以根据业务需求选择：

方向一：如果app_group确实需要复合主键 #

如果业务上app_group的主键必须由这三列共同组成，那你得调整role_group的表结构和实体映射：

1. 数据库层面：给role_group表添加app_id和group_id两列，和app_group的主键列一一对应
2. 实体映射层面：
   • 先给AppGroup实体创建一个可嵌入的复合主键类，用@Embeddable标注，包含三个主键字段，并且重写equals和hashCode方法（Hibernate识别复合主键必须依赖这两个方法）：

     @Embeddable
     public class AppGroupId implements Serializable {
         private String id;
         private String appId;
         private String groupId;
     
         // 构造方法、getter/setter
         @Override
         public boolean equals(Object o) {
             if (this == o) return true;
             if (o == null || getClass() != o.getClass()) return false;
             AppGroupId that = (AppGroupId) o;
             return Objects.equals(id, that.id) && Objects.equals(appId, that.appId) && Objects.equals(groupId, that.groupId);
         }
     
         @Override
         public int hashCode() {
             return Objects.hash(id, appId, groupId);
         }
     }
     

   • 在AppGroup实体中使用@EmbeddedId标注主键：

     @Entity
     @Table(name = "app_group")
     public class AppGroup {
         @EmbeddedId
         private AppGroupId id;
         // 其他业务字段和方法
     }
     

   • 在RoleGroup实体中，用@JoinColumns来指定多列外键的映射关系：

     @Entity
     @Table(name = "role_group")
     public class RoleGroup {
         @ManyToOne
         @JoinColumns({
             @JoinColumn(name = "app_group_id", referencedColumnName = "id"),
             @JoinColumn(name = "app_group_app_id", referencedColumnName = "app_id"),
             @JoinColumn(name = "app_group_group_id", referencedColumnName = "group_id")
         })
         private AppGroup appGroup;
         // 其他业务字段和方法
     }
     

方向二：如果app_group的主键设计有误 #

如果你其实只打算用id作为app_group的唯一主键，那修改起来更简单：

1. 数据库层面：把app_group的主键改成单一的id列，移除app_id和group_id的主键约束
2. 实体映射层面：调整AppGroup实体的主键映射，只用@Id标注id字段，这样RoleGroup里的app_group_id外键就能正常匹配了

最后提醒你：修改完之后一定要检查数据库表结构和实体映射的列名、字段类型是否完全一致，有时候拼写错误或者类型不匹配也会引发类似的报错哦～

备注：内容来源于stack exchange，提问作者Mahdi Sahebzamani