Spring Data JPA创建含已有Product的Sale时报唯一索引冲突

错误信息 #

org.h2.jdbc.JdbcSQLIntegrityConstraintViolationException: Unique index or primary key violation: "PUBLIC.UK_PENFKDX7890EQY3I2RH0BA4WV_INDEX_4 ON PUBLIC.SALE_PRODUCTS(PRODUCTS_ID NULLS FIRST) VALUES ( /* 7 */ CAST(7 AS BIGINT) )"; SQL statement: insert into sale_products (sale_id, products_id) values (?, ?) [23505-214]

问题根源 #

该错误核心原因：

1. 单向@OneToMany关联默认生成的中间表sale_products中，products_id被自动添加了唯一约束，导致同一个Product无法被多个Sale关联，违背业务逻辑；
2. 默认关联配置下，Hibernate处理关联插入的顺序可能导致Sale未生成ID就尝试插入中间表记录，触发约束冲突。

解决方案 #

1. 修正@OneToMany关联配置 #

显式配置中间表结构，关闭products_id的唯一约束，并合理设置级联策略：

@Entity
public class Sale {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String concept;
    @Temporal(TemporalType.DATE)
    private Date created_at;
    private Double price;
    @OneToOne(cascade = CascadeType.REFRESH)
    private Customer customer;

    // 显式配置中间表，关闭products_id的唯一约束
    @OneToMany(cascade = CascadeType.MERGE) // 根据业务需求选择级联策略，如MERGE/PERSIST
    @JoinTable(
        name = "sale_products",
        joinColumns = @JoinColumn(name = "sale_id"),
        inverseJoinColumns = @JoinColumn(name = "products_id", unique = false)
    )
    private Set<Product> products;

    // ... 构造方法、getter/setter、@PrePersist方法
}

2. 调整保存顺序，先持久化Sale再关联Product #

如果Product是已存在的实体，可先保存Sale获取ID，再设置Product集合并更新：

public SaleDTO save(SaleRegistrationRequest saleRegistrationRequest) {
    // 先创建不含Product的Sale对象
    Sale sale = new Sale(
            saleRegistrationRequest.concept(),
            findCustomerOfSale(saleRegistrationRequest.customerDTO()),
            null
    );
    // 先保存Sale，生成ID
    sale = saleRepository.save(sale);
    // 加载Product并关联
    Set<Product> products = convertProductsDTOToProduct(saleRegistrationRequest.productsDTO());
    sale.setProducts(products);
    // 更新Sale关联关系
    sale = saleRepository.save(sale);

    LOGGER.info("Sale saved successfully " + sale.toString());
    return saleDTOMapper.apply(sale);
}

3. 修复数据库表结构 #

若之前已生成带唯一约束的中间表，可通过以下方式修复：

• 开发环境设置spring.jpa.hibernate.ddl-auto=create-drop重建表结构；
• 手动删除数据库中sale_products表的UK_PENFKDX7890EQY3I2RH0BA4WV_INDEX_4唯一索引。

4. 确认Product为持久态对象 #

确保convertProductsDTOToProduct方法返回的是从数据库加载的持久态Product（现有代码通过findProductById获取，此部分无需修改），避免使用临时态对象导致关联异常。

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