Spring Security抛出异常时返回200而非预期500的问题排查

可能原因 #

• 异常被静默吞掉：RegistrationService或控制器代码里存在try-catch块，捕获了IllegalStateException但未重新抛出，也没返回错误响应
• 全局异常处理器配置错误：项目中的@ControllerAdvice/@RestControllerAdvice类，错误地将该异常处理为200成功响应
• 控制器错误返回成功状态：调用注册服务的控制器方法，在捕获异常后主动返回了200 OK而非错误状态码

排查步骤 #

1. 检查RegistrationService代码
   确认抛出异常的逻辑没有被无意义的try-catch包裹：

   // 正确写法（保证异常能传递到控制器）
   public void register(UserDto dto) {
       if(userRepository.existsByEmail(dto.getEmail())) {
           throw new IllegalStateException("该邮箱已注册");
       }
       // 其他注册逻辑
   }
   

   避免这种吞掉异常的错误写法：

   // 错误：捕获异常但未向上抛出
   public void register(UserDto dto) {
       try {
           if(userRepository.existsByEmail(dto.getEmail())) {
               throw new IllegalStateException("该邮箱已注册");
           }
       } catch (IllegalStateException e) {
           log.error("注册失败", e);
           // 无后续处理，异常被吞
       }
   }
   

2. 检查控制器方法
   确认控制器没有在捕获异常后返回200：

   // 错误写法：捕获异常却返回成功响应
   @PostMapping("/register")
   public ResponseEntity<String> register(@RequestBody UserDto dto) {
       try {
           registrationService.register(dto);
           return ResponseEntity.ok("注册成功");
       } catch (IllegalStateException e) {
           log.error(e.getMessage());
           return ResponseEntity.ok("注册失败"); // 错误返回200
       }
   }
   

3. 检查全局异常处理器
   查看项目中的全局异常处理类，确认对IllegalStateException的处理是否正确：

   @RestControllerAdvice
   public class GlobalExceptionHandler {
       // 错误写法：返回200状态码
       @ExceptionHandler(IllegalStateException.class)
       public ResponseEntity<String> handleIllegalState(IllegalStateException e) {
           return ResponseEntity.ok(e.getMessage());
       }
       // 正确写法
       // @ExceptionHandler(IllegalStateException.class)
       // public ResponseEntity<String> handleIllegalState(IllegalStateException e) {
       //     return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(e.getMessage());
       // }
   }
   

修复方案 #

• 若异常被try-catch吞掉：去掉多余的捕获逻辑，或在捕获后重新抛出异常
• 若控制器错误返回200：修改捕获块的响应状态码为HttpStatus.INTERNAL_SERVER_ERROR
• 若全局异常处理器配置错误：调整对应方法返回正确的500状态码

验证 #

修改后重启服务，用Postman重复注册已存在用户，检查响应状态码是否为500，同时确认控制台是否正常打印异常日志。

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