Spring JPA多对多关联下新增含唯一分类产品报重复键如何解决？

你遇到的重复键错误核心原因是Product实体的@ManyToMany注解配置了CascadeType.ALL，保存产品时会直接级联插入所有关联的Category对象，不会提前校验分类是否已存在，触发了name字段的唯一约束。

步骤1：扩展CategoryRepository，新增按名称查询分类的方法 #

package com.smolano.cupboard.repositories;

import com.smolano.cupboard.entities.Category;
import org.springframework.data.jpa.repository.JpaRepository;
import java.util.Optional;

public interface CategoryRepository extends JpaRepository<Category, Long> {
    // 新增按分类名称查询的方法
    Optional<Category> findByName(String name);
}

步骤2：调整产品保存的业务逻辑，预处理关联分类 #

在产品保存的Service层逻辑中，先对传入的分类集合做校验：已存在的分类直接复用持久化对象，不存在的再新建，再绑定到产品中保存，示例代码如下：

// 你的ProductService类示例
@Service
public class ProductService {
    @Autowired
    private ProductRepository productRepository;
    @Autowired
    private CategoryRepository categoryRepository;

    public Product createProduct(Product product) {
        Set<Category> processedCategories = new HashSet<>();
        // 遍历所有传入的分类
        for (Category reqCategory : product.getCategories()) {
            // 优先查询已存在的分类
            Category savedCategory = categoryRepository.findByName(reqCategory.getName())
                    // 分类不存在时再新增
                    .orElseGet(() -> categoryRepository.save(reqCategory));
            processedCategories.add(savedCategory);
        }
        // 替换为处理后的分类集合
        product.setCategories(processedCategories);
        // 保存产品
        return productRepository.save(product);
    }
}

可选优化：调整级联配置（推荐） #

如果你不需要级联删除分类的能力，可以将Product实体的多对多级联配置调整为仅保留新增和合并的级联，避免误操作删除分类：

// 修改Product实体的categories属性注解
@ManyToMany(cascade = {CascadeType.PERSIST, CascadeType.MERGE}, fetch = FetchType.LAZY)
@JoinTable(
        name = "product_categories",
        joinColumns = {@JoinColumn(name = "product_id")},
        inverseJoinColumns = {@JoinColumn(name = "category_id")}
)
private Set<Category> categories = new HashSet<>();

内容的提问来源于stack exchange，提问作者Santiago molano perdomo