Spring Data JPA：删除不存在ID时抛异常的配置解决方法

问题原因 #

Spring Data JPA默认实现SimpleJpaRepository中，deleteById和deleteAllById的内置逻辑是先通过ID查询实体，若找不到则直接抛出EmptyResultDataAccessException，这与CrudRepository文档描述的“忽略不存在ID”行为不符。

解决方案 #

1. 自定义静默删除方法（推荐，性能更优） #

通过@Query编写JPQL删除语句，直接执行数据库层面的删除操作，无需先查询实体，即使ID不存在也不会抛出异常：

单个ID删除

在你的Repository接口中添加：

@Modifying
@Query("DELETE FROM YourEntity e WHERE e.id = :id")
void deleteByIdSilently(@Param("id") String id);

批量ID删除

@Modifying
@Query("DELETE FROM YourEntity e WHERE e.id IN :ids")
void deleteAllByIdsSilently(@Param("ids") Collection<String> ids);

注意：调用这些方法的Service层方法需要添加@Transactional注解，因为@Modifying依赖事务支持。

2. 重写默认的deleteById/deleteAllById方法 #

如果希望保留原有方法名，可在Repository接口中重写默认实现，先判断实体是否存在再执行删除：

重写deleteById

@Override
default void deleteById(String id) {
    findById(id).ifPresent(this::delete);
}

重写deleteAllById

@Override
default void deleteAllById(Iterable<? extends String> ids) {
    ids.forEach(id -> findById(id).ifPresent(this::delete));
}

注意：这种方式会对每个ID执行一次查询+删除操作，当ID数量较多时会产生N+1查询问题，性能不如自定义批量删除方法。

3. 全局异常处理（不推荐） #

如果不想修改Repository或Service代码，可以通过全局异常处理器捕获EmptyResultDataAccessException，并忽略因删除不存在ID导致的异常：

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(EmptyResultDataAccessException.class)
    public ResponseEntity<Void> handleEmptyResultException(EmptyResultDataAccessException e) {
        if (e.getMessage().contains("No") && e.getMessage().contains("entity with id")) {
            return ResponseEntity.noContent().build();
        }
        throw e;
    }
}

这种方式不够精准，可能误忽略其他原因导致的EmptyResultDataAccessException，因此不推荐优先使用。

内容的提问来源于stack exchange，提问作者Tokoro-San