Spring Boot查询不存在数据返回500而非404的问题解决

嘿，我来帮你搞定这个问题！你遇到的核心问题是代码里的findById(id).get()调用先一步抛出了异常，导致你自定义的ResourceNotFoundException逻辑根本没机会执行。

问题根源 #

findById()方法返回的是Optional<Event>，当你调用.get()时，如果数据库里没有对应ID的数据，它会直接抛出NoSuchElementException——这个是Java原生的异常，Spring默认会把它转换成500 Internal Server Error，所以你后面判断event == null的代码完全走不到。

解决方案 #

按下面的步骤调整代码，就能让系统正确返回404：

1. 替换.get()为orElseThrow()，直接抛出自定义异常
   修改你的接口方法，用Optional的orElseThrow()方法替代get()，这样找不到数据时直接抛出你定义的ResourceNotFoundException：

   @PostMapping("/start/{id}")
   public ResponseEntity<String> startEvent(@PathVariable Long id) {
       // 找不到数据时直接抛自定义异常
       Event event = this.eventRepository.findById(id)
           .orElseThrow(() -> new ResourceNotFoundException("Event not found with ID: " + id));
       
       // 这里写你的业务逻辑，比如start相关操作
       return ResponseEntity.ok("Event started successfully");
   }
   

2. 确保你的ResourceNotFoundException是自定义运行时异常
   定义一个继承自RuntimeException的异常类，这样Spring能捕获到它：

   public class ResourceNotFoundException extends RuntimeException {
       public ResourceNotFoundException(String message) {
           super(message);
       }
   }
   

3. 配置全局异常处理器，将自定义异常映射为404响应
   创建一个全局异常处理类，用@RestControllerAdvice注解标记，专门处理ResourceNotFoundException，返回404状态码：

   import org.springframework.http.HttpStatus;
   import org.springframework.http.ResponseEntity;
   import org.springframework.web.bind.annotation.ExceptionHandler;
   import org.springframework.web.bind.annotation.RestControllerAdvice;
   
   @RestControllerAdvice
   public class GlobalExceptionHandler {
   
       @ExceptionHandler(ResourceNotFoundException.class)
       public ResponseEntity<String> handleResourceNotFound(ResourceNotFoundException ex) {
           // 返回404状态码和异常消息
           return new ResponseEntity<>(ex.getMessage(), HttpStatus.NOT_FOUND);
       }
   }
   

这样调整后，当查询不存在的ID时，系统会抛出ResourceNotFoundException，被全局处理器捕获后返回404 Not Found响应，而不是500错误啦！

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