快捷導(dǎo)航

解決@Validated對(duì)List對(duì)象驗(yàn)證失效問(wèn)題

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

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

@Validated對(duì)List對(duì)象驗(yàn)證失效

在實(shí)際開(kāi)發(fā)中，常常會(huì)對(duì)接口api入?yún)⒆龈袷津?yàn)證，有些入?yún)⑹荓ist數(shù)組對(duì)象。

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

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

因?yàn)锧Validated參數(shù)只能驗(yàn)證單個(gè)對(duì)象。

解決方法1

手動(dòng)對(duì)每一個(gè)參數(shù)對(duì)象進(jìn)行做驗(yàn)證，但是代碼會(huì)顯得冗余

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

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

@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，則需要將請(qǐng)求的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;
    }
    ```