SpringBoot--解决@Valid放在接口的List上时无效的问题

IT利刃出鞘2026-08-13 8:24

原文网址：SpringBoot--解决@Valid放在接口的List上时无效的问题_IT利刃出鞘的博客-CSDN博客

简介

本文介绍如何解决@Valid放在Controller的List类型的参数上时校验无效的问题。

问题复现

Controller

java 复制代码

package com.example.demo.business.validAndValidated.controller;

import com.example.demo.business.validAndValidated.entity.User;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.web.bind.annotation.*;

import javax.validation.Valid;
import java.util.List;

@Api(tags = "valid结合validated接口")
@RestController
@RequestMapping("validAndValidated")
public class ValidAndValidatedController {

    /**
     * 如果入参是List类型，则必须是@RequestBody，否则会报错
     */
    @ApiOperation("校验List")
    @PostMapping("validateList")
    public List<User> validateList(@RequestBody @Valid List<User> users) {
        return users;
    }
}

Entity

java 复制代码

package com.example.demo.business.validAndValidated.entity;

import lombok.Data;

import javax.validation.Valid;
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

@Data
public class User {
    @NotBlank(message = "名字不能为空")
    private String name;

    private Integer age;

    @Valid
    @NotNull(message = "账户不能为null")
    private Account account;
}

java 复制代码

package com.example.demo.business.validAndValidated.entity;
 
import lombok.Data;

import javax.validation.constraints.NotBlank;

@Data
public class Account {
    @NotBlank(message = "电话号码不能为空")
    private String phoneNumber;
}

测试

从下图可以看到，校验并没有生效。

原因分析

@Valid只能校验Java Bean，而List<E>不是JavaBean所以校验会失败。

解决方案

上边是文章的部分内容，为便于维护，全文已转移到此网址：SpringBoot-解决@Valid放在接口的List上时无效的问题 - 自学精灵