萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

AJAX error 回呼無法捕捉後端檢查型異常的解決方法

問題

後端主動拋出 Checked Exception(檢查型異常),前端 `$.ajax` 的 `error` 回呼卻捕捉不到,只有拋出 Runtime Exception(執行時異常) 才會觸發 `error`。

原因

Spring MVC 預設只將未捕獲的 RuntimeException 透過 `ResponseStatusExceptionResolver` 映射為 HTTP 5xx 錯誤碼;Checked Exception 若未被 `@ExceptionHandler` 或 `HandlerExceptionResolver` 處理,會被容器吞噬並回傳 200 OK(或自定義錯誤頁),導致 AJAX 以為成功。

解決方案

  1. 後端統一拋出 RuntimeException 子類(如 `BusinessException extends RuntimeException`),並加上 `@ResponseStatus(HttpStatus.BAD_REQUEST)`。
  2. 或配置全域異常處理器:
    @ControllerAdvice
    public class GlobalExceptionHandler {
        @ExceptionHandler(Exception.class)
        @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
        @ResponseBody
        public Map handle(Exception e) {
            return Map.of("success", false, "message", e.getMessage());
        }
    }
    
  3. 前端統一判斷:`success` 欄位為 false 即視為業務失敗,無論 HTTP 狀態碼。

最佳實務

  • 業務異常 → 自訂 RuntimeException + `@ResponseStatus(HttpStatus.BAD_REQUEST)`。
  • 系統異常 → 交給全域處理器回傳 500 並記錄日誌。
  • 前端 `error` 僅處理網路/HTTP 5xx,業務邏輯錯誤在 `success` 回呼中根據 `success:false` 處理。
copyright © 萬盛學電腦網 all rights reserved