使用@Validated注解異常信息的處理方式

更新時間：2025年07月31日 09:01:03 作者：艾默絲

本文優(yōu)化Spring @Validated參數(shù)校驗異常信息,通過MethodArgumentNotValidException和BindingResult提取關鍵錯誤,使用@RestControllerAdvice實現(xiàn)統(tǒng)一異常處理,提升錯誤信息簡潔性及代碼可維護性

使用@Validated注解異常信息的處理

我在使用spring提供的注解@Validated進行參數(shù)校驗時，發(fā)現(xiàn)默認的異常有點過于雜亂，本文就對這個問題優(yōu)化一下。

首先是接收參數(shù)的dto

StoreItemInfoDto .java

@Data
@AllArgsConstructor
@NoArgsConstructor
public class StoreItemInfoDto {
    @Field(name = "二維碼中心-批次id")
    @NotNull(message = "centerRecordId為空，請檢查")
    private Integer centerRecordId;
}

//接收請求的方法
MultiResponse<CodeInfoItemVo> queryCodeInfos(@Validated @RequestBody(required = true) StoreItemInfoDto storeItemInfoDto);

請求參數(shù)校驗失敗

我發(fā)現(xiàn)返回的信息過于雜亂且長，其實只需要最后“[ ]”里面的信息，今天就來對這個異常優(yōu)化一下。

解決方案

寫一個spring的統(tǒng)一異常處理，使用@ExceptionHandler注解標注，通過字符串截取“[ ]”里面的信息就可以

這樣返回的錯誤信息就簡潔明了

今天又發(fā)現(xiàn)了一個更為簡潔的寫法，這里用到MethodArgumentNotValidException異常類，查看其源碼，它對exception拋出的異常先進行了處理，而且它將校驗信息封裝到了BindingResult對象里面，我們可以直接根據getFieldErrors()方法拿到校驗不通過的信息；

MethodArgumentNotValidException.java

public class MethodArgumentNotValidException extends Exception {
    private final MethodParameter parameter;
    private final BindingResult bindingResult;

    public MethodArgumentNotValidException(MethodParameter parameter, BindingResult bindingResult) {
        this.parameter = parameter;
        this.bindingResult = bindingResult;
    }

    public MethodParameter getParameter() {
        return this.parameter;
    }

    public BindingResult getBindingResult() {
        return this.bindingResult;
    }
	//這里對異常進行了封裝
    public String getMessage() {
        StringBuilder sb = (new StringBuilder("Validation failed for argument [")).append(this.parameter.getParameterIndex()).append("] in ").append(this.parameter.getExecutable().toGenericString());
        if (this.bindingResult.getErrorCount() > 1) {
            sb.append(" with ").append(this.bindingResult.getErrorCount()).append(" errors");
        }

        sb.append(": ");
        Iterator var2 = this.bindingResult.getAllErrors().iterator();

        while(var2.hasNext()) {
            ObjectError error = (ObjectError)var2.next();
            sb.append("[").append(error).append("] ");
        }

        return sb.toString();
    }
}

基于MethodArgumentNotValidException這個類我們可以把方法改寫為如下：

    @ExceptionHandler(MethodArgumentNotValidException.class)
    public SingleResponse<?> handlerException(MethodArgumentNotValidException e) {
        BindingResult bindingResult = e.getBindingResult();
        String errorMsg = bindingResult.getFieldErrors().stream().map(o -> o.getDefaultMessage()).collect(Collectors.joining(","));
        return SingleResponse.buildFailure(ResultCodeEnum.CONSTRAINT_VIOLATION_ERROR.getCode(), errorMsg);
    }

拓展

@RestControllerAdvice是一個組合注解，由@ControllerAdvice、@ResponseBody組成，而@ControllerAdvice繼承了@Component，因此@RestControllerAdvice本質上是個Component，用于定義@ExceptionHandler，@InitBinder和@ModelAttribute方法，適用于所有使用@RequestMapping方法。

@RestControllerAdvice的特點：

1.通過@ControllerAdvice注解可以將對于控制器的全局配置放在同一個位置。
2.注解了@RestControllerAdvice的類的方法可以使用@ExceptionHandler、@InitBinder、@ModelAttribute注解到方法上。
3.@RestControllerAdvice注解將作用在所有注解了@RequestMapping的控制器的方法上。
4.@ExceptionHandler：用于指定異常處理方法。當與@RestControllerAdvice配合使用時，用于全局處理控制器里的異常。
5.@InitBinder：用來設置WebDataBinder，用于自動綁定前臺請求參數(shù)到Model中。
6.@ModelAttribute：本來作用是綁定鍵值對到Model中，當與@ControllerAdvice配合使用時，可以讓全局的@RequestMapping都能獲得在此處設置的鍵值對