Spring Boot JPA删除记录触发完整性约束违反错误解决

当前JPA关联配置存在3处核心问题，导致外键约束报错、功能不符合预期：

1. Category侧的@OneToMany未配置mappedBy属性，JPA无法识别这是和Product侧category字段对应的双向关联，默认会尝试生成独立中间表维护关系，和Product表实际存在的category_id外键字段脱节，删除Category时不会先处理Product表中指向该记录的外键引用，直接触发外键约束异常。
2. 双向关联未做状态同步，JPA不会自动维护两侧的关联关系，删除Product时Category侧的products集合会残留已删除的对象引用。
3. 代码中使用getOne()获取的是JPA懒加载代理对象，若持久化上下文提前关闭会导致代理状态异常，删除实体时优先使用findById()获取真实持久态对象更稳妥。

@Entity
public class Category {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    @OneToMany(
            mappedBy = "category",
            fetch = FetchType.LAZY,
            cascade = CascadeType.ALL,
            orphanRemoval = true
    )
    private List<Product> products = new ArrayList<>();

    // 双向关联维护工具方法，避免两侧状态不一致
    public void addProduct(Product product) {
        products.add(product);
        product.setCategory(this);
    }

    public void removeProduct(Product product) {
        products.remove(product);
        product.setCategory(null);
    }

    // 省略无参构造、getter、setter
}

@Entity
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;

    @ManyToOne(fetch = FetchType.EAGER)
    @JoinColumn(name = "category_id")
    private Category category;

    // 省略无参构造、getter、setter
}

• 实现「删除Category自动级联删除关联Product」

  • mappedBy = "category"明确关联由Product侧的外键字段维护，JPA可以正确识别Product表对Category的引用关系
  • cascade = CascadeType.ALL包含REMOVE级联规则，JPA执行Category删除前会先遍历所有关联Product执行删除操作
  • orphanRemoval = true做兜底校验，只要Product脱离了Category的关联集合，就会被自动删除，避免漏删
    注意：@ManyToOne侧不要配置任何包含REMOVE的级联规则，否则删除Product时会连带删除关联的Category，完全违背业务逻辑

• 实现「删除Product时自动从所属Category的products集合移除」

  • 不要直接调用Repository删除未做关联同步的Product对象，所有关联操作必须在事务上下文中执行，先通过实体类内置的removeProduct()方法解除双向关联，再执行删除操作，JPA会自动同步持久化上下文的状态。

所有数据库操作必须放在加了@Transactional注解的Service层方法中执行，保证关联操作在同一个持久化上下文内完成：

@Service
@Transactional
public class GoodsService {
    private final ProductRepository productRepository;
    private final CategoryRepository categoryRepository;

    // 构造注入
    public GoodsService(ProductRepository productRepository, CategoryRepository categoryRepository) {
        this.productRepository = productRepository;
        this.categoryRepository = categoryRepository;
    }

    // 删除商品
    public void deleteProduct(Long productId) {
        Product product = productRepository.findById(productId)
                .orElseThrow(() -> new IllegalArgumentException("指定商品不存在"));
        Category belongCategory = product.getCategory();
        // 先解除双向关联
        belongCategory.removeProduct(product);
        // 再执行删除
        productRepository.delete(product);
    }

    // 删除分类
    public void deleteCategory(Long categoryId) {
        Category category = categoryRepository.findById(categoryId)
                .orElseThrow(() -> new IllegalArgumentException("指定分类不存在"));
        // 配置了级联删除，直接调用delete即可自动删除所有关联商品，不会触发外键约束错误
        categoryRepository.delete(category);
    }
}

额外排查点：如果你的数据库表是配置修改前就已经创建好的，需要检查Product表的category_id外键约束策略，如果数据库层面设置的是RESTRICT（拒绝删除存在关联引用的主表记录），就算JPA配置正确，也可能因SQL执行顺序问题触发报错。这种情况可以删除旧表让JPA按新配置重新生成，或者手动修改外键约束为级联删除策略。

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