Spring JPA/Hibernate实现含多对一外键的复合主键报错问题咨询

问题原因 #

你遇到的转换异常是JPA复合主键映射规则不匹配导致的：当你将@Id注解标注在@ManyToOne关联属性上时，@IdClass指定的主键类中，对应关联属性的字段不能是实体类型，必须是关联实体的主键类型（此处Metadata的主键为Long类型）。框架从数据库读取到metadata_id字段的Long值后，无法直接转换为Metadata实体，因此抛出了类型转换异常。

解决方案 #

方案1：直接修正现有IdClass实现 #

仅需修改SensorDataId类，将其中的metadata字段类型改为Long即可，其余代码无需改动：

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import java.io.Serializable;

@NoArgsConstructor
@AllArgsConstructor
@Data
public class SensorDataId implements Serializable {
    private Long timestamp;
    // 改为关联实体Metadata的主键类型Long，字段名和SensorData中@Id标注的关联属性名保持一致
    private Long metadata;
}

方案2：改用@EmbeddedId实现（更直观不易出错） #

如果希望映射逻辑更清晰，可以换用嵌入式主键的实现方式：

1. 改造主键类为嵌入式类型

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import javax.persistence.Embeddable;
import java.io.Serializable;

@Embeddable
@Data
@NoArgsConstructor
@AllArgsConstructor
public class SensorDataId implements Serializable {
    private Long timestamp;
    private Long metadataId;
}

2. 修改SensorData实体映射

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import javax.persistence.*;

@Data
@Entity
@AllArgsConstructor
@NoArgsConstructor
public class SensorData {
    @EmbeddedId
    private SensorDataId id;

    private Double x;
    private Double y;
    private Double z;

    @MapsId("metadataId") // 绑定嵌入式主键中的metadataId字段
    @ManyToOne
    @JoinColumn(name = "metadata_id", nullable = false)
    private Metadata metadata;
}

注意事项 #

• 保存SensorData前需要先持久化对应的Metadata实例，再将其赋值给SensorData的metadata属性，避免出现游离对象相关报错
• 若使用Spring Data JPA的findById等主键查询方法，需要传入完整的SensorDataId实例作为参数

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