SpringBoot項目中@RestControllerAdvice全局異常失效問題的解決

更新時間：2024年11月01日 10:39:41 作者：Eric-x

@RestController注解是一個用于定義RESTful Web服務的控制器的特殊注解,它是@Controller和@ResponseBody注解的結合體,意味著你不需要在每個處理請求的方法上都添加@ResponseBody,本文給大家介紹了解決SpringBoot項目中@RestControllerAdvice全局異常失效問題

1、問題

使用@RestControllerAdvice添加了全局異常，但沒有生效

/**
 * 全局異常處理
 * @author Eric
 * @date 2022-10-08 10:00:22
 */
@RestControllerAdvice
public class ExceptionControllerAdvice {

    private static final Logger logger = LoggerFactory.getLogger(WxRedpackController.class);

    /**
     * 用來攔截valid的校驗
     * @param e
     * @return
     */
    @ExceptionHandler(value = MethodArgumentNotValidException.class)
    public Object handleVaildException(MethodArgumentNotValidException e) {
        logger.info("數(shù)據(jù)校驗出現(xiàn)問題：{}，異常類型：{}", e.getMessage(), e.getClass());
        BindingResult result = e.getBindingResult();
        if (result.hasErrors()) {
            Map<String, String> errorMap = new HashMap<>();
            result.getFieldErrors().forEach((item) -> {
                //獲取到的錯誤提示
                String message = item.getDefaultMessage();
                //獲取到的錯誤屬性名稱
                String field = item.getField();
                errorMap.put(field, message);
            });
            return ResponseUtil.fail(DATA_ERROR.code(),errorMap);
        }
        return ResponseUtil.fail();
    }


    /**
     * 攔截未知的運行時異常
     */
    @ExceptionHandler(RuntimeException.class)
    public Object notFount(RuntimeException e) {
        logger.info("運行時異常:", e);
        return ResponseUtil.fail(DATA_ERROR.code(),e.getMessage());
    }

    /**
     * 系統(tǒng)異常
     */
    @ExceptionHandler(Exception.class)
    public Object handleException(Exception e) {
        logger.info(e.getMessage(), e);
        return ResponseUtil.fail(DATA_ERROR.code(),"服務器網(wǎng)絡擁堵，請稍后再試");
    }

}

2、解決

方式1：@ExceptionHandler 所在類沒有被Spring管理

因為 @SpringbootApplication默認掃描本包和子包，為了防止全局異常類未被掃描到，建議在啟動類上加上包掃描

方式2：AOP process() 沒有異常拋出，自然不會被攔截掉。檢查項目中的切面編程，查看是否在某個切面將異常try-catch，然后沒有扔出來。

方式3：在@RestControllerAdvice @ConrollerAdivce 所在的類使用@Order(999999)，注意這里不要引用錯誤的包了了，org.springframework.core.annotation.Order