Hibernate复合主键外键映射异常：列数量不匹配问题求助

嘿，我仔细看了你遇到的问题，这个异常的核心原因其实是你的Product实体映射出现了冲突——你同时混用了两种复合主键的映射方式，还多了个多余的嵌入字段，导致Hibernate错误识别了Product的主键结构，才抛出了外键列数不匹配的错误。咱们一步步来修复：

第一步：修正Product实体的主键映射逻辑 #

你已经定义了ProductId作为复合主键类并加了@Embeddable注解，这时应该用@EmbeddedId来映射主键，而不是同时用@IdClass+两个单独的@Id字段（两种复合主键映射方式选一种即可，这里用@EmbeddedId更贴合你已有的代码）。

修改后的Product实体代码：

@Entity
@Table(name = "PRODUCT")
@RequiredArgsConstructor
public class Product extends BaseEntity implements Serializable {

    private static final long serialVersionUID = 1L;

    @EmbeddedId
    private ProductId id; // 用EmbeddedId替代原来的两个@Id字段和@IdClass注解

    @OneToMany(fetch = FetchType.LAZY, cascade = CascadeType.ALL, mappedBy = "product")
    private List<ProductDetail> productDetailList;

    // 注意：删掉原来单独的productId、productPartitionDate字段，以及多余的ProductKey字段
    // 如果需要访问主键属性，直接通过id.getProductId()、id.getProductPartitionDate()获取即可
    // other fields
}

ProductId类保持现有代码不变，它的字段名和数据库列名已经对应匹配，无需额外调整。

第二步：调整ProductDetail的外键映射细节 #

你的ProductDetail里的@ManyToOne映射逻辑本身没问题，但建议把referencedColumnName的名字和数据库列名严格对齐，避免Hibernate因大小写敏感出现识别错误：

@ManyToOne
@JoinColumns({
    @JoinColumn(name = "product_id", referencedColumnName = "product_id", nullable = false),
    @JoinColumn(name = "product_partition_date", referencedColumnName = "product_partition_date", nullable = false)
})
private Product product;

另外，ProductDetail的主键映射（@IdClass+两个@Id字段）是正确的，不需要改动。

第三步：补充一个小细节修正 #

你在Product的productPartitionDate字段用了@Temporal(TemporalType.DATE)，但数据库中对应的列是timestamp without time zone，建议改成@Temporal(TemporalType.TIMESTAMP)，避免日期类型不匹配引发其他隐性问题。

为什么之前会报错？ #

你原来的Product实体同时使用了@IdClass、两个@Id字段，还额外嵌入了ProductKey（这个类你没贴代码，但属于冗余配置），Hibernate解析时因这些冲突的配置，错误地认为Product的主键只有单个字段，导致外键的两个列和主键的一个列无法匹配，最终抛出了那个映射异常。

按照上面的步骤修改后，Hibernate就能正确识别Product的复合主键结构，ProductDetail的外键列也能和主键列一一对应，这个异常应该就能解决了。

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