如何正确映射JPA多对一关联至复合主键实体？

你的错误根源在于错误地将@ManyToOne（实体关联注解）和@Embedded（值对象嵌入注解）混用在同一个字段上，导致Hibernate试图把SubCategory的代理对象（LAZY加载生成）赋值给CategoryCompositeKey类型的字段，触发类型不匹配异常。

以下是两种可行的修复方案：

方案1：关联SubCategory实体（推荐，符合ORM设计） #

直接在Catalog中关联SubCategory实体，通过@JoinColumns指定复合外键的映射关系：

@Entity
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "product_catalog")
public class Catalog {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    private String description;
    private String blurb;
    private String type;
    private String surfaceType;

    // 关联SubCategory实体，而非复合键类
    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumns({
        @JoinColumn(name = "category_id", referencedColumnName = "categoryId"),
        @JoinColumn(name = "subcategory_id", referencedColumnName = "subcategoryId")
    })
    private SubCategory subCategory;

    @OneToMany(mappedBy = "catalog", fetch = FetchType.LAZY)
    private List<Selection> selections;
}

说明 #

• 这样Hibernate会正确处理实体关联，LAZY加载时生成的SubCategory代理对象可以正常赋值给SubCategory类型字段
• 需要获取复合键时，直接通过catalog.getSubCategory().getCompositeKey()即可
• 同时可以直接访问SubCategory的其他属性（如category、thumbnail），无需额外查询

方案2：仅存储复合键（不关联实体） #

如果业务不需要关联SubCategory实体，仅需存储外键值，可去掉@ManyToOne，仅保留@Embedded并明确字段映射：

@Entity
@Getter
@Setter
@Builder
@NoArgsConstructor
@AllArgsConstructor
@Table(name = "product_catalog")
public class Catalog {

    @Id
    @GeneratedValue(strategy = GenerationType.UUID)
    private UUID id;

    private String description;
    private String blurb;
    private String type;
    private String surfaceType;

    // 仅嵌入复合键值对象，不关联实体
    @Embedded
    @AttributeOverrides({
        @AttributeOverride(name = "categoryId", column = @Column(name = "category_id")),
        @AttributeOverride(name = "subcategoryId", column = @Column(name = "subcategory_id"))
    })
    private CategoryCompositeKey categoryCompositeKey;

    @OneToMany(mappedBy = "catalog", fetch = FetchType.LAZY)
    private List<Selection> selections;
}

说明 #

• 此方式仅映射数据库的外键字段到复合键对象，不会关联SubCategory实体，避免代理对象赋值问题
• 缺点是无法直接通过Catalog获取SubCategory的其他属性，需要手动执行查询

补充：为什么自定义Setter无效？ #

Hibernate在加载实体时是直接通过反射操作字段，不会调用你自定义的setCategoryCompositeKey(SubCategory)方法，因此这个Setter无法解决类型不匹配的问题。

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