Spring JPA：实现一对多关系中单个子实体的删除方法

你当前的代码存在几个关键问题导致删除失败，下面给出完整的修正方案和实现思路：

一、先修正实体类的基础问题 #

你的Product类缺少@Entity和@Table注解，JPA无法将其识别为数据库实体，这会导致所有关联操作失效。修正后的Product实体：

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "products")
public class Product {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @Column(nullable = false)
    private String category; // 枚举值示例：洁面产品、爽肤水、保湿霜、防晒霜、精华液....

    @Column(nullable = false)
    private String brand;

    @Column(nullable = false)
    private int size;

    @Column()
    private String review; // 是否仅在全部产品页面显示？
}

你的Routine实体的一对多映射配置没问题，orphanRemoval=true和CascadeType.ALL可以保留，后续按规则操作即可生效。

二、修正控制器的参数错误 #

控制器中@PathVariable("name")的参数名是name，但方法内用的是productName，变量名不匹配会导致参数无法正确传递，修正后：

@DeleteMapping("{id}/{name}")
public ResponseEntity<String> deleteRoutineProduct(@PathVariable("id") Long routineId, @PathVariable("name") String productName){
    productService.deleteProduct(routineId, productName);
    return new ResponseEntity<>("Product deleted successfully.", HttpStatus.OK);
}

三、两种可行的Service层实现方案 #

方案1：利用orphanRemoval机制（基于父实体关联删除） #

这种方案需要操作持久态的父实体，让JPA自动跟踪子实体的移除并删除数据库记录：

@Service
public class ProductService {

    @Autowired
    private RoutineRepository routineRepository;

    @Transactional
    public void deleteProduct(Long routineId, String productName) {
        // 1. 从数据库加载持久态的Routine对象（必须是持久态，否则JPA无法跟踪变化）
        Routine routine = routineRepository.findById(routineId)
                .orElseThrow(() -> new RuntimeException("未找到ID为" + routineId + "的护肤流程"));

        // 2. 从关联列表中找到目标产品
        Product targetProduct = routine.getProducts().stream()
                .filter(product -> product.getName().equals(productName))
                .findFirst()
                .orElseThrow(() -> new RuntimeException("该流程下未找到名为" + productName + "的产品"));

        // 3. 从父实体的集合中移除子实体
        routine.getProducts().remove(targetProduct);

        // 4. 保存父实体，触发orphanRemoval删除子记录
        routineRepository.save(routine);
    }
}

关键注意点：

• 必须加@Transactional注解，确保整个操作在事务内执行，JPA才能跟踪实体状态变化。
• 必须从数据库加载Routine（持久态），如果是手动创建的对象或者游离状态的对象，移除子实体不会触发删除。
• 如果一个流程下有多个同名产品，这个方法只会删除第一个，若需要处理同名场景，建议结合产品ID或其他唯一条件筛选。

方案2：直接通过ProductRepository删除（更高效） #

这种方式不需要加载父实体，直接通过子实体的Repository按条件删除，适合只需要删除子实体的场景：

首先创建ProductRepository：

@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    // 自定义删除方法，根据routine_fk和产品名称删除
    void deleteByRoutineIdAndName(Long routineId, String name);
}

然后实现Service方法：

@Service
public class ProductService {

    @Autowired
    private ProductRepository productRepository;

    @Transactional
    public void deleteProduct(Long routineId, String productName) {
        productRepository.deleteByRoutineIdAndName(routineId, productName);
    }
}

这种方式更简洁高效，不需要处理父实体的关联集合，直接操作子实体的数据库记录。

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