Spring Data JPA 一对多多列关联外键列数不匹配该如何解决？

报错根因 #

Event实体的主键仅为id单个字段，而你在Category实体的@ManyToOne关联中配置了3个外键列，JPA要求关联外键的列数必须和被关联表的主键列数完全一致，因此触发了列数不匹配的报错。
另外你当前的实体设计逻辑也存在问题：ageLevels、genders是Event下的公共配置集合，不属于Event的主键组成部分，不应该作为关联Event的外键字段。

代码修改方案 #

1. 重构Category实体 #

在Category中单独存储当前分类对应的年龄、性别字段，仅用单个外键关联Event主键：

import com.fasterxml.jackson.annotation.JsonIgnore;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import lombok.ToString;

import javax.persistence.*;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

@Data
@AllArgsConstructor
@NoArgsConstructor
@ToString
@Entity
@Table(name="TBL_Categories",
    // 新增联合唯一约束：同一个赛事下同一个年龄+性别组合仅能有一个分类
    uniqueConstraints = @UniqueConstraint(columnNames = {"event_id", "age_level", "gender"})
)
public class Category {

    @Id
    @GeneratedValue(strategy = GenerationType.SEQUENCE)
    private int category_id;

    @NotBlank
    private String categoryName;

    // 新增当前分类对应的年龄层级
    @NotNull
    @Enumerated(EnumType.STRING) // 若AgeLevel不是枚举类型可删除该注解
    private AgeLevel ageLevel;

    // 新增当前分类对应的性别
    @NotNull
    @Enumerated(EnumType.STRING) // 若Gender不是枚举类型可删除该注解
    private Gender gender;

    @ManyToOne
    @JsonIgnore
    // 仅保留单个外键关联Event的主键id，外键列名改为event_id避免重名冲突
    @JoinColumn(name = "event_id", nullable = false)
    private Event event;
}

2. 优化Event实体配置 #

修正集合字段的校验注解（@NotBlank仅适用于字符串，集合非空校验需用@NotEmpty），可按需添加关联级联配置：

// 其余包引入保持不变
import javax.validation.constraints.NotEmpty;

@Data
@AllArgsConstructor
@NoArgsConstructor
@Entity
@Table(name="TBL_EVENT", uniqueConstraints = {
        @UniqueConstraint(columnNames = "name")
})
public class Event {

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

    @NotBlank
    @Column(name = "name",unique=true)
    private String name;

    // 替换@NotBlank为@NotEmpty
    @NotEmpty
    @ElementCollection
    @CollectionTable(name = "event_ageLevels", joinColumns = @JoinColumn(name = "event_id"))
    @Column(name = "age_level")
    @Enumerated(EnumType.STRING)
    private Set<AgeLevel> ageLevels;

    // 替换@NotBlank为@NotEmpty
    @NotEmpty
    @ElementCollection
    @CollectionTable(name = "event_genders", joinColumns = @JoinColumn(name = "event_id"))
    @Column(name = "gender")
    @Enumerated(EnumType.STRING)
    private Set<Gender> genders;

    @NotBlank
    @DateTimeFormat
    private String registrationEndDate;

    // 按需添加级联配置，保存Event时自动保存关联的Category
    @OneToMany(mappedBy = "event", cascade = CascadeType.ALL, orphanRemoval = true)
    private Set<Category> categories;

}

Category生成逻辑示例 #

你可以通过双层循环生成两个集合的笛卡尔积，批量生成符合要求的Category：

// 假设已获取到待处理的Event对象event
Set<Category> categories = new HashSet<>();
int categoryIndex = 1;
for (AgeLevel ageLevel : event.getAgeLevels()) {
    for (Gender gender : event.getGenders()) {
        Category category = new Category();
        category.setCategoryName(String.format("%s Category%d %s %s", 
            event.getName(), categoryIndex++, ageLevel.name(), gender.name()));
        category.setAgeLevel(ageLevel);
        category.setGender(gender);
        category.setEvent(event);
        categories.add(category);
    }
}
event.setCategories(categories);
// 保存event即可自动生成所有关联的category
eventRepository.save(event);

效果验证 #

修改后不会再出现外键列数不匹配的报错，表结构完全符合设计要求：

• TBL_EVENT仅用id作为主键，存储赛事基础信息和允许的年龄、性别配置集合
• TBL_Categories用event_id关联赛事主键，每个分类单独存储对应的年龄、性别，同一个赛事下不会出现重复的年龄性别组合分类

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