SpringBoot 3.5中JSR-303校验失效？

Question

在升级至Spring Boot 3.5后，部分开发者发现原有的JSR-303 Bean Validation（如@NotNull、@Size等）校验失效，接口接收参数时未触发预期的校验异常。问题根源在于Spring Boot 3.x默认不再自动引入Hibernate Validator的执行依赖，且需手动添加`spring-boot-starter-validation` starter。此外，Jakarta EE 9+已将`javax.validation`迁移至`jakarta.validation`，若项目混用旧版API或依赖冲突，会导致校验注解不生效。需检查依赖配置及包导入是否正确。

Answer 1

1. 问题现象：Spring Boot 3.5 中 Bean Validation 校验失效

在升级至 Spring Boot 3.5 后，部分开发者反馈原有的 JSR-303 注解（如 @NotNull、@Size、@NotBlank 等）在校验 Controller 接收的请求参数时不再触发校验异常。例如，当传递一个空字符串或 null 值给标注了 @NotBlank 的字段时，系统未抛出 MethodArgumentNotValidException，导致后端逻辑接收到非法数据。

• 表现形式：接口调用成功，但实际应被拦截的非法参数未被检测。
• 日志中无任何校验相关的错误输出。
• @Valid 或 @Validated 注解看似“静默失效”。

2. 深层原因分析：从依赖变更到包命名迁移

该问题的核心源于两个关键变化：

1. Spring Boot 3.x 不再默认引入 Hibernate Validator 执行器：此前版本（如 2.7.x）通过 spring-boot-starter-web 隐式包含验证支持，但从 3.0 起，验证功能被剥离为可选模块。
2. Jakarta EE 9+ 的包命名空间迁移：Java EE 已正式移交至 Eclipse 基金会，并更名为 Jakarta EE。因此，所有相关 API 包名由 javax.* 迁移至 jakarta.*。这意味着原本导入的 javax.validation.constraints.NotNull 在新环境中无法识别。

项目阶段	包路径	所属规范版本
Spring Boot 2.x / Java EE	javax.validation.*	JSR-303 / JSR-380
Spring Boot 3.x / Jakarta EE	jakarta.validation.*	Bean Validation 3.0 (Jakarta)

3. 解决方案步骤详解

要彻底解决此问题，需按以下顺序进行配置和代码调整：

3.1 添加 spring-boot-starter-validation 依赖

确保 pom.xml 或 build.gradle 中显式声明 starter：

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

3.2 更新所有校验注解的 import 包路径

将旧的 javax.validation 替换为新的 jakarta.validation：

// 错误（旧版）
import javax.validation.constraints.NotBlank;
import javax.validation.constraints.Size;

// 正确（新版）
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;

3.3 检查第三方库兼容性

某些中间件（如 Swagger/OpenAPI、Lombok、MapStruct）若使用旧版 validation API，可能导致冲突。建议升级至支持 Jakarta EE 的版本，例如：

• Springdoc OpenAPI v2.x 支持 Jakarta
• Lombok 1.18.30+ 提供对 jakarta.validation 兼容支持

4. 验证流程图：Bean Validation 生效判断逻辑

graph TD
    A[接收HTTP请求] --> B{是否使用@Valid/@Validated?}
    B -- 否 --> C[跳过校验]
    B -- 是 --> D[加载Validator实现]
    D --> E{是否存在jakarta.validation API?}
    E -- 否 --> F[报ClassNotFoundException或No validator found]
    E -- 是 --> G[执行ConstraintValidation]
    G --> H{校验通过?}
    H -- 否 --> I[抛出MethodArgumentNotValidException]
    H -- 是 --> J[继续处理业务逻辑]

5. 常见排查清单（Checklist）

遇到校验不生效时，可参照下表逐项排查：

#	检查项	推荐操作
1	是否添加 spring-boot-starter-validation	检查依赖树：mvn dependency:tree | grep validation
2	注解导入是否为 jakarta.validation.constraints	全局搜索替换 javax.validation
3	Controller 参数是否使用 @Valid 或 @Validated	确认位置正确，如方法参数前
4	是否存在 multiple validation providers 冲突	排除重复的 hibernate-validator 版本
5	自定义约束注解是否也迁移到 jakarta 包	检查自定义 validator 的 imports 和 SPI 配置
6	测试用例是否模拟了校验场景	编写单元测试验证异常是否抛出
7	Spring Context 是否加载了 LocalValidatorFactoryBean	通过 @Autowired 注入 Validator 并调试
8	是否启用了 method validation（如 service 层校验）	需配合 @EnableMethodValidation 使用 @Validated
9	是否有 IDE 缓存导致误判	清理编译缓存并重新构建项目
10	日志级别是否开启 DEBUG for org.springframework.validation	查看校验过程详细输出