JPA嵌入式复合主键映射报错：基础属性类型不应为持久化实体

数据库结构 #

Table : product
        prod_id
        ...

Table : product_category
        prod_id
        category_id 
        ...

product_category表在(prod_id,category_id)上有唯一约束。

JPA代码实现 #

@Entity
@Table(name = "product")
public class ProductEntity implements Serializable {
    ...
    @OneToMany(mappedBy = "product")
    private List<ProductCategoryEntity> productCategories = new ArrayList<>();
    ...
}   

@Embeddable
public class ProductCategoryPK implements Serializable {
    @Column(name = "prod_id")
    private ProductEntity product; //Compiler error : 'Basic' attribute type should not be 'Persistence Entity' 
    @Column(name = "category_id")
    private Integer categoryId;
    
    ...
}   

@Entity
@Table(name = "product_category")
public class ProductCategoryEntity implements Serializable {
    
    @EmbeddedId
    private ProductCategoryPK key;

    @ManyToOne
    @MapsId("prod_id")
    private ProductEntity product;
    
    ...
}

在ProductCategoryPK类的private ProductEntity product;行，编辑器提示编译错误：'Basic' attribute type should not be 'Persistence Entity'，无法解决该映射问题，寻求帮助。

问题根源在于嵌入式主键类的定义不符合JPA规范：嵌入式主键的属性只能是基本类型、可嵌入类型或它们的集合/数组，不能直接引用持久化实体类。结合你已经在ProductCategoryEntity中使用@MapsId做实体关联的情况，只需做以下修改：

1. 修改嵌入式主键类ProductCategoryPK #

将实体引用改为对应字段的数值类型，同时实现equals和hashCode方法（JPA要求嵌入式主键必须实现这两个方法）：

@Embeddable
public class ProductCategoryPK implements Serializable {
    @Column(name = "prod_id")
    private Integer prodId; // 替换为prod_id对应的数值类型，此处用Integer示例，可根据实际调整
    @Column(name = "category_id")
    private Integer categoryId;
    
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        ProductCategoryPK that = (ProductCategoryPK) o;
        return Objects.equals(prodId, that.prodId) && Objects.equals(categoryId, that.categoryId);
    }

    @Override
    public int hashCode() {
        return Objects.hash(prodId, categoryId);
    }

    // 此处可添加getter、setter方法
}

2. 调整ProductCategoryEntity中的关联注解 #

修改@MapsId的参数，匹配主键类中的字段名：

@Entity
@Table(name = "product_category")
public class ProductCategoryEntity implements Serializable {
    
    @EmbeddedId
    private ProductCategoryPK key;

    @ManyToOne
    @MapsId("prodId") // 对应主键类中的prodId字段
    @JoinColumn(name = "prod_id")
    private ProductEntity product;
    
    ...
}

修改逻辑说明 #

• 嵌入式主键类仅存储数据库表中的原始字段值，避免直接引用实体类，符合JPA对主键类的要求。
• 通过@MapsId("prodId")将ProductEntity的ID映射到主键类的prodId字段，既维护了实体间的关联关系，也保证了复合主键的约束生效。

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