Spring Data JPA 多对多复合主键关联保存触发Long转实体的类型转换异常

核心错误来自@IdClass注解的强制匹配规则不满足：

• 规则要求：复合主键类的属性，必须和关联主实体上标注@Id的属性同名、类型匹配。当主实体的@Id属性是@ManyToOne关联对象时，对应主键类的属性类型必须是该关联对象的主键Java类型（也就是外键列对应的实际存储类型），不能是关联对象本身的类型。
• 现有代码中，连接实体CardDeckIntersection的两个@Id属性是Card、Deck对象类型，对应的CardDeckIntersectionId主键类也定义了同类型的Card、Deck属性，和ORM的元数据解析逻辑冲突。ORM解析时会把外键列存储的Long类型主键值（Card.id、Deck.id），尝试赋值给主键类的字段，最终触发类型转换异常。

第一步 调整复合主键类的定义 #

将主键类中的关联对象类型，替换为对应关联实体的主键类型，保证属性名和连接实体的关联属性完全一致：

@Data
public class CardDeckIntersectionId implements Serializable {
    // 属性名和连接实体的@ManyToOne属性名完全匹配
    // 类型对应Card、Deck实体的主键类型（Long）
    private Long card;
    private Long deck;
}

第二步 明确连接实体的外键映射 #

为连接实体上的两个@Id关联属性指定明确的外键列名，避免ORM自动映射生成的列名和实际数据库结构不匹配：

@Data
@Entity
@Table(name = "card_deck_intersection")
@IdClass(CardDeckIntersectionId.class)
public class CardDeckIntersection {

    @Id
    @ManyToOne
    @JoinColumn(name = "card_id") // 指定关联Card表的外键列
    private Card card;

    @Id
    @ManyToOne
    @JoinColumn(name = "deck_id") // 指定关联Deck表的外键列
    private Deck deck;

}

• 复合主键类必须保留无参构造、equals、hashCode方法的实现，使用Lombok的@Data注解可以自动生成上述方法，前提是字段类型调整为简单主键类型后，计算逻辑会基于两个Long值完成，不会出现对象引用的比较问题。
• 保存CardDeckIntersection实例时，要确保传入的Card、Deck关联对象是已持久化的状态（存在有效的Long类型主键值），不能传入瞬时态的游离对象，否则会触发外键约束异常。
• 不要在复合主键类中定义关联对象类型字段，复合主键类的作用是承载可序列化的简单主键标识，关联关系的持久化逻辑全部由连接实体本身的@ManyToOne注解负责。

内容的提问来源于stack exchange，提问作者M.Lipiński