快捷導(dǎo)航

解決@Validated對List對象驗證失效問題

更新時間：2025年09月25日 08:58:01 作者：to方圓圓

文章指出@Validated注解無法驗證List數(shù)組參數(shù),建議手動逐項驗證或封裝List為對象進(jìn)行驗證,前者代碼冗余但直接,后者需調(diào)整JSON結(jié)構(gòu)但更簡潔,根據(jù)需求選擇方案,權(quán)衡靈活性與參數(shù)改造成本

@Validated對List對象驗證失效

在實際開發(fā)中，常常會對接口api入?yún)⒆龈袷津炞C，有些入?yún)⑹荓ist數(shù)組對象。

  public ApiResponse receiveManualTranscoding(@Validated @RequestBody List<SdZmDto> sdZmDtos)

其實這樣是失效的，會發(fā)現(xiàn)其SdZmDto并不會進(jìn)行驗證。

因為@Validated參數(shù)只能驗證單個對象。

解決方法1

手動對每一個參數(shù)對象進(jìn)行做驗證，但是代碼會顯得冗余

private ResultVo validate(@Valid SdZmDto gwbaDto) {
        Set<ConstraintViolation<@Valid SdZmDto >> validateSet = Validation.buildDefaultValidatorFactory()
                .getValidator()
                .validate(gwbaDto);
        if (!CollectionUtils.isEmpty(validateSet)) {
            String messages = validateSet.stream()
                    .map(ConstraintViolation::getMessage)
                    .reduce((m1, m2) -> m1 + "；" + m2)
                    .orElse("參數(shù)輸入有誤！");
            return ResultVo.builder().code(ResultConstants.FALSE).message(SYSTEM_ERROR_TSBAMESSAGE + messages).build();
        }
        return null;
    }

解決方法2

定義一個對象，將list封裝進(jìn)行，則驗證就驗證單個對象了。

@Data
public class ValidList<E> implements List<E> {
  @Valid
  private List<E> list = new ArrayList<>();
}
將  public ApiResponse receiveManualTranscoding(@Validated @RequestBody List<SdZmDto> sdZmDtos) 
改成
public ApiResponse receiveManualTranscoding(@Validated @RequestBody ValidList<SdZmDto> sdZmDtos)

選擇方案

解決方法1雖然冗余代碼，但是符合需求，如果采用方法2，則需要將請求的json參數(shù)進(jìn)行做調(diào)整。

 @PostMapping("/receiveManualTranscoding")
    @ResponseBody
    public ApiResponse receiveManualTranscoding(@RequestBody List<SdZmDto> sdZmDtos) {
        for(SdZmDto sdZmDto : sdZmDtos){
            ApiResponse apiResponse = null;
            if((apiResponse = validate(sdZmDto)) != null){
                return apiResponse;
            }
        }
        ajmApiService.receiveManualTranscoding(sdZmDtos);
        return ApiDataResponse.ofSuccess();
    }

    private ApiResponse validate(@Valid SdZmDto sdZmDto) {
        Set<ConstraintViolation<@Valid SdZmDto >> validateSet = Validation.buildDefaultValidatorFactory()
                .getValidator()
                .validate(sdZmDto);
        if (!CollectionUtils.isEmpty(validateSet)) {
            String messages = validateSet.stream()
                    .map(ConstraintViolation::getMessage)
                    .reduce((m1, m2) -> m1 + "；" + m2)
                    .orElse("參數(shù)輸入有誤！");
            return ApiResponse.ofFail(messages);
        }
        return null;
    }
    ```