Spring Data Rest模块DELETE HTTP方法无法正常工作问题

基于Spring Boot 2.3.8.RELEASE开发应用，未自定义编写Controller层，完全依赖Spring Data REST模块自动暴露Repository层的HTTP接口。
项目父依赖配置如下：

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.8.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

定义的Repository层代码如下：

public interface PUCCRepository extends CrudRepository<PUCCertificate, Long> {

    @Transactional
    Long deleteByVehicleNo(@RequestParam("vehicleNo") String vehicleNo);
   
}

调用deleteByVehicleNo相关删除接口时：

• 使用GET请求可以正常删除对应记录，成功场景截图：
  
• 使用DELETE HTTP方法发起请求时无法成功删除数据，失败场景截图：
  

Spring Data REST的默认HTTP方法映射规则存在边界：

1. 框架仅对Repository内置的CRUD方法做标准RESTful语义映射，例如内置的deleteById方法会自动绑定到DELETE /{资源路径}/{id}路由。
2. 开发者自定义的派生删除方法（比如deleteByVehicleNo），会被框架识别为普通的自定义查询方法，自动挂载到/search/{方法名}路径下，仅支持GET请求，不会自动生成对应DELETE方法的路由。
3. 用GET请求能成功删除，本质是调用到了/search路径下的GET端点，直接触发了方法内的删除逻辑；直接发DELETE请求到对应路径时，服务端找不到匹配的请求方法路由，自然无法执行删除操作。

风险提示：用GET请求触发删除操作本身违反HTTP方法语义规范，GET请求要求无副作用、可缓存，这类实现很容易被浏览器预加载、爬虫扫描、代理缓存等逻辑触发意外数据删除，存在严重安全隐患，生产环境必须禁止。

二选一即可，推荐第二种更稳妥：

方案1：显式配置自定义方法的REST暴露规则 #

在Repository方法上添加@RestResource注解，同时自定义Spring Data REST配置类，为该方法开放DELETE请求权限：

public interface PUCCRepository extends CrudRepository<PUCCertificate, Long> {

    @Transactional
    @RestResource(path = "deleteByVehicleNo", rel = "deleteByVehicleNo")
    Long deleteByVehicleNo(@Param("vehicleNo") String vehicleNo);
   
}

配置类示例：

@Component
public class CustomRestConfig implements RepositoryRestConfigurer {
    @Override
    public void configureRepositoryRestConfiguration(RepositoryRestConfiguration config, CorsRegistry cors) {
        config.withEntityLookup()
          .forRepository(PUCCRepository.class, PUCCRepository::deleteByVehicleNo, PUCCRepository::findByVehicleNo);
    }
}

这种方式不需要写额外Controller，但配置相对繁琐，容易出现语义混淆。

方案2：自定义Controller层显式绑定DELETE路由 #

编写薄层Controller，明确指定DELETE请求映射，完全规避Spring Data REST默认映射的歧义问题：

@RestController
@RequestMapping("/pucCertificates")
public class PUCCController {

    private final PUCCRepository pucRepository;

    // 构造注入
    public PUCCController(PUCCRepository pucRepository) {
        this.pucRepository = pucRepository;
    }

    @DeleteMapping("/deleteByVehicleNo")
    public ResponseEntity<Long> deleteByVehicleNo(@RequestParam String vehicleNo) {
        Long deletedCount = pucRepository.deleteByVehicleNo(vehicleNo);
        return ResponseEntity.ok(deletedCount);
    }
}

这种方式语义清晰，HTTP方法和操作逻辑完全匹配，也方便后续加参数校验、权限控制等逻辑，是生产环境的首选实现。

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