SpringBoot如何校验请求参数对象内部的嵌套实体字段

你碰到的持久化阶段校验失败问题，本质是两层校验规则的触发逻辑没对齐：

• Controller层的@Valid入参校验没有正常拦住空的信用卡字段，非法值一路传到了持久化层
• JPA持久化层校验默认会在实体持久化、更新的生命周期节点触发Bean Validation校验，你在CreditCard类里加的@NotBlank注解没有指定校验分组，默认属于持久化阶段会触发的默认校验组，空值落库时直接触发了校验异常。

代码里的显性问题 #

• Sale类中private CreditCard creditCard字段声明末尾缺失分号，属于语法错误，正常编译阶段就会报错，需要先补上。
• 如果你的项目是Spring Boot 2.3及以上版本，校验依赖不再随web starter自动引入，缺依赖的情况下Controller层的@Valid注解完全不生效，非法参数会直接穿透到持久层。
• 要确认Sale类里creditCard字段上的@Valid注解引的是校验规范对应的包（javax.validation.Valid或者jakarta.validation.Valid，依项目的JavaEE/JakartaEE版本而定），引错包会导致嵌套校验不触发。

修复步骤 #

1. 补全代码语法错误，给Sale类的creditCard字段声明末尾加分号。
2. 引入校验依赖，Maven项目在pom.xml中添加如下依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>
</dependency>

3. 如果你不需要JPA层面的持久化校验，直接在配置文件里关闭该功能即可：

# 放在application.properties中
spring.jpa.properties.javax.persistence.validation.mode=none

4. 如果需要保留持久化层校验，就逐层排查空值穿透的原因：
   • 确认前端传参的JSON字段名和CreditCard类的cardNumber、cvv字段名完全一致，避免反序列化时字段赋值为空
   • 排查fooService.saveFoo方法内的业务逻辑，确认没有在处理过程中把信用卡对象的卡号、cvv字段置空
   • 测试接口时确认请求体格式正确，creditCard节点是嵌套在Sale对象下的，不要把卡号、cvv字段直接放在请求体最外层。

内容的提问来源于stack exchange，提问作者idkaname