JPA含复合主键实体的@JoinTable多对多关联配置报错排查

你遇到的核心问题是Plans实体使用复合主键，但配置@JoinTable时未完整映射所有主键字段，同时存在joinColumn的referencedColumnName与字段不匹配的错误，导致Hibernate无法正确解析关联关系。

错误点拆解 #

• Plans的复合主键包含planId和planDate两个字段，多对多关联的中间表必须同时存储这两个字段作为外键，关联到plans表的主键
• 你当前的@JoinTable仅配置了一个joinColumn，且错误地将planDate列关联到planId字段，完全不符合映射规则

修正后的Plans实体类 #

@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table(name = "plans")
@IdClass(PlansPKId.class)
public class Plans {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private long planId;

    @Id
    @Column
    @Temporal(TemporalType.DATE) // 明确指定日期类型，避免timestamp时区问题
    private Date planDate; // format: yyyy-mm-dd

    @Column
    private String planName;

    @Column
    private String weekday;

    @ManyToMany
    @JoinTable(
        name = "Plan_Meds",
        joinColumns = {
            @JoinColumn(name = "plan_id", referencedColumnName = "planId"), // 映射复合主键的planId
            @JoinColumn(name = "plan_date", referencedColumnName = "planDate") // 映射复合主键的planDate
        },
        inverseJoinColumns = @JoinColumn(name = "med_id", referencedColumnName = "id") // 明确关联Meds的id，列名更清晰
    )
    private Set<Meds> assignedMeds = new HashSet<>();

}

关键说明 #

1. 复合主键关联规则：关联使用复合主键的实体时，必须在joinColumns中列出所有主键对应的外键列，不能遗漏任何一个，否则Hibernate无法唯一定位关联实体记录。
2. 列名匹配要求：name是中间表的外键列名，referencedColumnName是关联实体（Plans）的主键字段名，必须一一对应，不能混淆。
3. 日期类型优化：添加@Temporal(TemporalType.DATE)注解，确保planDate存储为纯日期格式，避免默认timestamp类型带来的时间精度问题。
4. 中间表结构要求：Plan_Meds表需包含plan_id（bigint）、plan_date（date）、med_id（bigint）三个字段，建议将这三个字段设为联合主键，同时分别建立外键关联到plans表的plan_id/plan_date，以及meds表的id。

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