Spring Data JPA一对多映射关联已有产品触发主键重复异常问题咨询

问题根因 #

你的代码存在两个核心问题，直接导致了报错：

1. 实体关联关系设计错误：当前用@OneToMany关联Customer和Product，相当于限定一个产品只能属于一个客户，外键cp_fk存储在Product表中，一条Product记录只能关联一个Customer主键，自然无法让多个客户关联同一个Product记录。
2. 级联策略配置不合理：你配置了cascade = CascadeType.ALL，保存Customer时会自动尝试把关联的Product都作为新实体插入数据库，当Product主键已经存在时就会触发主键重复异常。

可行解决方案 #

根据业务场景可以选择以下两种方案：

方案1：调整为@ManyToMany关联（无额外购买属性场景） #

如果不需要记录每个用户购买产品的个性化属性（比如购买数量、购买时间等），直接修改实体关联为多对多即可：

@Entity
public class Customer {
    @Id
    @GeneratedValue
    private int id;
    private String name;
    private String email;
    private String gender;
    // 改为多对多关联，去掉自动插入/更新产品的级联规则
    @ManyToMany(fetch = FetchType.LAZY)
    // 配置中间表存储关联关系，不影响Product原有数据
    @JoinTable(
        name = "customer_product_rel",
        joinColumns = @JoinColumn(name = "customer_id", referencedColumnName = "id"),
        inverseJoinColumns = @JoinColumn(name = "product_id", referencedColumnName = "pid")
    )
    private List<Product> products;
    // 省略getter、setter
}

Product实体不需要做修改，若需要反向查询产品关联的所有客户，可以加上反向关联：

@ManyToMany(mappedBy = "products")
private List<Customer> customers;

最后调整业务层保存逻辑：

• 接收请求的Product列表后，先根据pid查询数据库中已存在的Product
• 不存在的Product再执行插入，已存在的直接复用查询到的持久化对象
• 把这些Product对象设置到Customer的products属性中，再保存Customer即可

方案2：新增购买记录中间实体（推荐，适配实际业务场景） #

实际业务中用户购买产品通常会有额外属性（购买数量、购买时间、支付金额等），你原本写在Product表中的qty本身就不属于产品基础属性，更适合抽成中间表存储：

1. 新增购买记录实体：

@Entity
public class CustomerPurchase {
    @Id
    @GeneratedValue
    private Long id;
    @ManyToOne
    @JoinColumn(name = "customer_id")
    private Customer customer;
    @ManyToOne
    @JoinColumn(name = "product_id")
    private Product product;
    // 存储该用户本次购买该产品的数量
    private Integer purchaseQty;
    // 可扩展购买时间、支付单价等字段
    // 省略getter、setter
}

2. 调整Customer实体关联：

@Entity
public class Customer {
    @Id
    @GeneratedValue
    private int id;
    private String name;
    private String email;
    private String gender;
    @OneToMany(mappedBy = "customer", cascade = CascadeType.ALL, orphanRemoval = true)
    private List<CustomerPurchase> purchaseList;
    // 省略getter、setter
}

3. 简化Product实体为基础属性：

@Entity
public class Product {
    @Id
    private int pid;
    private String productName;
    private int price;
    // 省略getter、setter
}

4. 调整业务保存逻辑：
   保存客户时，遍历请求传入的产品列表，先根据pid查询Product实体，不存在则先创建Product；再为每个Product构造CustomerPurchase对象，关联当前Customer和查询到的Product，设置购买数量；最后保存Customer即可，完全不会出现主键冲突，也天然支持同一产品被多个客户购买。

注意事项 #

• 不要随意使用CascadeType.ALL对关联实体做级联插入/更新，尤其是关联的是公共基础数据（比如产品、类目这类）时，极易触发不必要的异常。
• 实体关系设计要匹配业务逻辑：只要业务上是多对多的关联，就不要用单向一对多实现，避免出现数据只能关联一次的逻辑问题。

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