如何在JPA一对多关联中避免Allergen实体重复存储？

核心原因 #

你当前的问题出在两个关键点：

1. 关联关系与业务需求不匹配：@OneToMany定义的是「一个Ingredient拥有多个Allergen，且每个Allergen只能属于一个Ingredient」的关系，这和你想让多个Ingredient共享同一个Allergen的需求矛盾，所以JPA会把每个关联的Allergen判定为新实体执行插入。
2. 未使用持久化上下文托管的实体：即使手动设置ID，新建的Allergen对象处于游离态（未被JPA上下文管理），JPA依然会将其视为新实体插入数据库。

解决方案 #

1. 修正关联关系为多对多（推荐，匹配共享Allergen的业务场景）

如果Allergen需要被多个Ingredient共享，应该使用@ManyToMany双向关联，通过中间表维护两者的关联关系：

Ingredient类代码：

public class Ingredient {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @ManyToMany
    @JoinTable(
        name = "ingredient_allergen", // 自定义中间表名称
        joinColumns = @JoinColumn(name = "ingredient_id"), // 关联Ingredient的外键字段
        inverseJoinColumns = @JoinColumn(name = "allergen_id") // 关联Allergen的外键字段
    )
    private List<Allergen> allergens;

    // getter、setter、构造方法
}

Allergen类代码：

public class Allergen {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 给name字段加唯一约束，从数据库层面避免重复
    @Column(unique = true)
    private String name;

    @ManyToMany(mappedBy = "allergens") // 关联Ingredient中的allergens属性，维护双向关系
    private List<Ingredient> ingredients;

    // getter、setter、构造方法

    // 基于唯一属性name实现equals和hashCode，帮助JPA识别重复实体
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Allergen allergen = (Allergen) o;
        return Objects.equals(name, allergen.name);
    }

    @Override
    public int hashCode() {
        return Objects.hash(name);
    }
}

2. 保存Ingredient时关联已有Allergen

保存前先从数据库查询目标Allergen，存在则直接关联，不存在再创建并保存：

// 示例：使用Spring Data JPA的Repository实现逻辑
public void saveIngredientWithAllergens() {
    // 查询是否存在名为"gluten"的Allergen
    Allergen gluten = allergenRepository.findByName("gluten");
    if (gluten == null) {
        // 不存在则创建并保存到数据库
        gluten = new Allergen();
        gluten.setName("gluten");
        gluten = allergenRepository.save(gluten);
    }

    // 创建Ingredient并关联已有的gluten
    Ingredient ingredient = new Ingredient();
    ingredient.setAllergens(Collections.singletonList(gluten));
    ingredientRepository.save(ingredient);
}

3. 若坚持使用一对多（仅适用于Allergen专属单个Ingredient的场景）

如果业务上Allergen只能属于一个Ingredient，需调整级联策略避免自动保存新实体，并确保关联的是数据库中已存在的托管态Allergen：

Ingredient类修改：

public class Ingredient {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // 移除CascadeType.PERSIST/CascadeType.ALL，避免级联保存新的Allergen
    @OneToMany(cascade = {CascadeType.MERGE, CascadeType.REFRESH})
    private List<Allergen> allergens;

    // getter、setter
}

保存逻辑：
必须先通过ID从数据库获取已存在的Allergen（托管态），再关联到Ingredient：

Allergen existingAllergen = allergenRepository.findById(1L).orElseThrow();
Ingredient ingredient = new Ingredient();
ingredient.getAllergens().add(existingAllergen);
ingredientRepository.save(ingredient);

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