Spring Data JPA多对多关系：如何禁用双向插入实现单向插入

在多对多双向关联场景下，重复插入关联表记录的核心原因是双方都被当作关联关系的维护端，导致Hibernate生成两次插入语句到中间关联表。要实现单向插入，只需明确维护端与非维护端，并仅通过维护端操作关联关系即可。

具体实现步骤 #

1. 配置实体类，明确维护端与非维护端

在双向多对多关联中，必须指定其中一方为维护端（负责更新中间表），另一方为非维护端（仅映射关联，不操作中间表）。通过@ManyToMany注解的mappedBy属性标记非维护端：

• 主实体（维护端）ProduceCategoryModel：

@Entity
public class ProduceCategoryModel {
    @Id
    private Long id;

    // 维护端：负责插入/更新中间表
    @ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE})
    @JoinTable(
        name = "sub_produce_categories",
        joinColumns = @JoinColumn(name = "produceCategoryId"),
        inverseJoinColumns = @JoinColumn(name = "subProduceCategoryId")
    )
    private Set<SubProduceCategoryModel> subCategories = new HashSet<>();

    // getter、setter、添加关联的方法
    public void addSubCategory(SubProduceCategoryModel subCategory) {
        this.subCategories.add(subCategory);
        // 注意：不要在这里操作非维护端的集合，避免双向触发
        // subCategory.getParentCategories().add(this); // 这行必须删掉
    }
}

• 子分类实体（非维护端）SubProduceCategoryModel：

@Entity
public class SubProduceCategoryModel {
    @Id
    private Long id;

    // 非维护端：通过mappedBy指向维护端的关联属性subCategories
    @ManyToMany(mappedBy = "subCategories")
    private Set<ProduceCategoryModel> parentCategories = new HashSet<>();

    // getter、setter
    // 不要在这里添加操作关联的方法，避免触发非维护端的更新逻辑
}

2. 仅通过维护端操作关联关系

插入关联时，只操作维护端的集合，然后保存维护端实体，不要同时操作非维护端的关联集合：

// 示例：插入produceCategoryId=68与subProduceCategoryId=69的关联
ProduceCategoryModel mainCategory = produceCategoryRepository.findById(68L).orElseThrow();
SubProduceCategoryModel subCategory = subProduceCategoryRepository.findById(69L).orElseThrow();

// 仅通过维护端添加关联
mainCategory.addSubCategory(subCategory);
produceCategoryRepository.save(mainCategory);

关键注意事项 #

• 禁止在维护端的关联添加方法中操作非维护端的集合，否则会再次触发非维护端的更新逻辑，导致重复插入。
• 确保中间表sub_produce_categories的produceCategoryId和subProduceCategoryId组合设置了唯一约束，即使代码层面控制，数据库层面的约束也能避免意外重复。

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